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.
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_countebookmark_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_replyeis_quote_status.- Idioma em
lang.
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 comlang: produzem conjuntos por idioma mais organizados.
Continue até o fim do cursor
Pare apenas quandonext_cursor estiver nulo, vazio ou ausente, não quando a página tiver poucos itens. Veja paginação.
Relacionados
- Busca: referência do endpoint.
- Operadores: dicionário completo.
- Paginação: cursores.
- Monitoramento em tempo real: combine histórico e coleta contínua.
- Menções: menções históricas.
- Otimização: reduza o consumo.