Skip to main content
A Sorsa oferece acesso ao arquivo de dados públicos do X desde março de 2006. Consultas históricas usam os mesmos endpoints, autenticação e paginação das recentes, sem faixa separada de arquivo completo, contrato empresarial ou restrição de janela de busca. Elas consomem a mesma cota e podem ser testadas com as 100 requisições gratuitas, sem cartão. Este guia descreve os endpoints, os dados disponíveis e os padrões para grandes consultas. Veja comparação de métodos, exportação CSV e outros exemplos no guia do blog.

Endpoints

/search-tweets aceita os operadores do X, incluindo since:, until:, from:, to:, min_faves:, min_retweets:, lang: e filter:, dentro de query. /user-tweets recebe apenas um identificador (user_link, username ou user_id) e retorna a timeline sem filtros de consulta.

Busca histórica por palavra-chave

Use /search-tweets para buscar em todas as contas dentro de um período:
order aceita "latest" (cronológico) ou "popular" (engajamento). Use latest para coleta por período e popular para encontrar conteúdo de maior engajamento.

Timeline completa de uma conta

/user-tweets percorre do mais recente ao mais antigo, sem limite de 3.200 publicações.
Envie exatamente um identificador e percorra next_cursor até ficar nulo. Para limitar uma conta por datas, use busca com from:, como from:naval since:2020-01-01 until:2021-01-01. /user-tweets não aceita filtros de data.

Dados retornados

Publicações históricas têm os mesmos campos das recentes:
  • Texto completo, sem truncamento ou substituição de URLs.
  • likes_count, retweet_count, reply_count, quote_count, view_count e bookmark_count.
  • Perfil completo do autor em user.
  • Mídias e prévias de links em entities.
  • conversation_id_str, in_reply_to_tweet_id, is_reply e is_quote_status.
  • Idioma em lang.
Veja formato de resposta.

Limitações da plataforma

São restrições do X, não específicas da Sorsa:
  • Publicações excluídas saem do índice e não podem ser recuperadas.
  • Contas protegidas não aparecem em buscas públicas ou timelines.
  • Perfis não são históricos. Uma publicação de 2014 traz bio, nome e seguidores atuais.
  • Métricas não são retratos do passado. Curtidas, repostagens e visualizações mostram os totais atuais. Para séries históricas de métricas, capture e armazene os dados com monitoramento em tempo real.

Boas práticas

Divida períodos grandes

Uma consulta de vários anos dificulta retomadas e auditoria por período. Divida por mês em coletas anuais e por semana em eventos intensos.

Reduza o ruído de repostagens

Use -filter:nativeretweets para pesquisar sentimento, opiniões ou padrões de conteúdo original. -filter:retweets também exclui repostagens antigas no formato RT.

Combine datas e engajamento

since:/until: com min_faves: ou min_retweets: reduz ruído e consumo.

Separe temas globais por idioma

Consultas distintas com lang: produzem conjuntos por idioma mais organizados.

Continue até o fim do cursor

Pare apenas quando next_cursor estiver nulo, vazio ou ausente, não quando a página tiver poucos itens. Veja paginação.

Relacionados