Formato de Exportação do Mastodon em ActivityPub JSON: Como Ler

Quando você exporta seus dados do Mastodon, o arquivo contém arquivos no formato ActivityPub JSON. Esses arquivos armazenam suas postagens, listas de seguidores e metadados da conta de forma estruturada para leitura por máquinas. Muitos usuários corporativos acham o JSON bruto confuso por usar objetos aninhados e nomes de propriedades incomuns como @context e actor. Este artigo explica a estrutura dos arquivos JSON de exportação do Mastodon, mostra como abrir e interpretar cada seção e oferece dicas práticas para localizar campos de dados específicos.

O Que É ActivityPub JSON nas Exportações do Mastodon

O Mastodon exporta seus dados como um arquivo ZIP que contém vários arquivos JSON. Cada arquivo segue o protocolo ActivityPub, um padrão W3C para redes sociais descentralizadas. Os arquivos JSON usam um esquema específico definido pelo ActivityPub, que inclui propriedades como @context, type, actor, object e published. O campo @context aponta para o vocabulário ActivityPub, informando a qualquer interpretador como ler os dados. O campo type identifica se o objeto JSON é um Note para uma postagem, um Person para um usuário ou um Follow para uma relação de seguidor.

O arquivo de exportação contém arquivos JSON separados para diferentes categorias de dados:

• outbox.json — Contém todas as suas postagens públicas. Cada entrada é uma atividade Create do ActivityPub com um objeto Note incorporado.
• following.json — Lista as contas que você segue. Cada entrada é uma atividade Follow apontando para o actor alvo.
• followers.json — Lista as contas que seguem você. Cada entrada é uma atividade Follow do actor seguidor.
• likes.json — Contém suas curtidas ou favoritos. Cada entrada é uma atividade Like com o objeto alvo.
• actor.json — Armazena os dados do perfil da sua própria conta, incluindo nome de exibição, resumo e URL do ícone.

Cada arquivo JSON é uma matriz de objetos ActivityPub. Você pode abrir qualquer arquivo em um editor de texto, mas um visualizador JSON torna a estrutura aninhada muito mais fácil de navegar.

Como Abrir e Ler Arquivos JSON de Exportação do Mastodon

Antes de ler o JSON, você precisa extrair o arquivo de exportação e escolher um visualizador. Siga estas etapas para acessar e interpretar seus dados de exportação do Mastodon.

1. Solicite seu arquivo de exportação do Mastodon
   Faça login na sua instância do Mastodon. Vá em Preferências > Importar e Exportar > Exportar. Clique no botão “Exportar seus dados.” O Mastodon gera um arquivo ZIP e oferece para download. Salve o arquivo no seu computador.
2. Extraia o arquivo ZIP
   Clique com o botão direito no arquivo ZIP baixado e selecione Extrair Tudo no Windows ou use o Archive Utility no macOS. A extração cria uma pasta com o nome do seu identificador de conta do Mastodon. Dentro você verá os arquivos JSON listados acima.
3. Abra um arquivo JSON com um editor de texto ou visualizador JSON
   Clique com o botão direito em qualquer arquivo JSON, escolha Abrir Com e selecione um editor de texto simples como Notepad no Windows ou TextEdit no macOS. Para uma experiência melhor, instale uma extensão de navegador para visualizar JSON, como JSON Viewer ou JSON Formatter. Em seguida, arraste o arquivo JSON para o navegador para ver seções recolhíveis e sintaxe colorida.
4. Identifique a matriz de nível superior e os objetos
   Cada arquivo JSON começa com um colchete de abertura [ e termina com um colchete de fechamento ]. Isso significa que o arquivo contém uma matriz de objetos. Cada objeto é delimitado por chaves {} e representa uma atividade ActivityPub.
5. Leia o campo type para entender o que o objeto representa
   Dentro de cada objeto, localize a propriedade type. Para outbox.json, os tipos comuns são Create e Announce. Para following.json e followers.json, o tipo é Follow. Para likes.json, o tipo é Like. O type informa qual ação a atividade representa.
6. Encontre o campo object para o conteúdo real
   Em outbox.json, cada atividade Create contém um campo object. O valor de object é outro objeto JSON com tipo Note. Dentro do objeto Note, procure por content para ver o texto da postagem, published para o timestamp e attachment para arquivos de mídia.
7. Localize o campo actor para ver quem realizou a ação
   Toda atividade tem uma propriedade actor. O valor é uma URL que aponta para o perfil do actor ActivityPub. Para suas próprias postagens, a URL do actor é a URL do seu perfil do Mastodon. Para seguidores, a URL do actor é a URL do perfil do seguidor.
8. Verifique o campo published para timestamps
   Atividades e objetos Note incluem um campo published com uma string de data ISO 8601, como 2025-03-15T14:30:00Z. Isso informa quando a ação ocorreu ou quando a postagem foi criada.

Problemas Comuns ao Ler JSON de Exportação do Mastodon

Arquivo JSON aparece como uma única linha de texto

Ao abrir um arquivo JSON em um editor de texto básico, todo o conteúdo pode aparecer como uma longa linha. Isso acontece porque a exportação remove espaços em branco para reduzir o tamanho do arquivo. Use um visualizador JSON ou um editor de código como Visual Studio Code para formatar automaticamente o JSON com quebras de linha e indentação. No Visual Studio Code, pressione Shift+Alt+F para formatar o documento.

Não é possível encontrar o conteúdo da postagem em outbox.json

Se você vir uma atividade Create mas o campo object mostrar uma URL em vez de um objeto aninhado, o conteúdo da postagem não está incluído na exportação. O Mastodon exporta apenas os metadados e a referência da URL para algumas postagens mais antigas. Para ver o conteúdo completo, abra a URL em um navegador. Essa limitação se aplica a postagens criadas antes da implementação completa do recurso de exportação na sua instância.

Lista de seguidores mostra URLs em vez de nomes de exibição

O arquivo followers.json armazena cada seguidor como uma atividade Follow. O campo actor contém a URL do perfil do seguidor, não o nome de exibição. Para obter o nome de exibição, você precisa buscar o JSON do actor nessa URL. As exportações do Mastodon não incluem o perfil completo do actor para cada seguidor devido a restrições de privacidade e tamanho dos dados.

Arquivo JSON não abre ou exibe caracteres distorcidos

Se o arquivo JSON contiver caracteres não ASCII de postagens em outros idiomas, um editor de texto simples pode exibir texto distorcido. Abra o arquivo com um editor compatível com UTF-8, como Notepad++ no Windows ou BBEdit no macOS. No Notepad++, vá em Encoding e selecione Codificar em UTF-8 para exibir caracteres especiais corretamente.

Item	outbox.json	following.json
Estrutura de nível superior	Matriz de objetos Activity	Matriz de atividades Follow
Valor do tipo primário	Create, Announce, Like	Follow
Localização do conteúdo	object.content	object é a URL do actor alvo
Campo de timestamp	published no Note	published na atividade Follow
Anexos de mídia	object.attachment	Não se aplica

Agora você pode abrir qualquer arquivo JSON de exportação do Mastodon e localizar os campos principais para postagens, seguidores e dados da conta. Use uma extensão de navegador para visualizar JSON e recolher grandes matrizes, focando em atividades específicas. Para análises avançadas, tente importar o JSON para uma ferramenta de planilha como Microsoft Excel usando Power Query, que pode analisar colunas JSON aninhadas em linhas.