Autenticação
Recent search
O recent search suporta múltiplos métodos de autenticação:Full-archive search
O full-archive search suporta apenas autenticação OAuth 2.0 App-Only.Criando queries
As queries usam operadores para corresponder a Posts. Combine operadores com lógica booleana:Limites de tamanho da query
Tipos de operador
Criar uma query
Aprenda a sintaxe de query em detalhes
Referência de operadores
Veja todos os operadores disponíveis
Fields e expansions
Por padrão, a resposta inclui apenasid, text e edit_history_tweet_ids. Use parâmetros para solicitar dados adicionais.
Exemplo de requisição
cURL
Expansions disponíveis
Guia de fields e expansions
Saiba mais sobre como personalizar respostas
Paginação
Endpoints de busca retornam resultados em páginas. Use onext_token da resposta para buscar páginas adicionais.
Como funciona
- Faça sua requisição inicial com
max_results - Verifique o objeto
metaem busca denext_token - Inclua
next_tokennas requisições subsequentes - Repita até que nenhum
next_tokenseja retornado
Exemplo
cURL
Guia de paginação
Saiba mais sobre paginação
Edições de Post
Posts podem ser editados até 5 vezes dentro de 30 minutos. Os endpoints de busca sempre retornam a versão mais recente.Considerações
edit_history_tweet_idscontém todos os IDs de Post (mais antigos primeiro)- Posts buscados após a janela de 30 minutos representam a versão final
- Para casos de uso em quase tempo real, Posts publicados recentemente ainda podem ser editados
Fundamentos de edição de Posts
Saiba mais sobre edições de Post
Melhores práticas
Comece específico
Use múltiplos operadores para restringir resultados e reduzir ruído.
Teste iterativamente
Comece amplo e refine com base nos resultados.
Trate paginação
Implemente paginação adequada para grandes conjuntos de resultados.
Cache dos resultados
Armazene os resultados localmente para evitar requisições repetidas.
Próximos passos
Criar uma query
Domine a sintaxe de query
Referência de operadores
Todos os operadores disponíveis
Paginação
Lide com grandes conjuntos de resultados
Referência da API
Documentação completa do endpoint