Skip to main content
Este guia cobre os conceitos-chave que você precisa para integrar os endpoints de Search Posts à sua aplicação.

Autenticação

O recent search suporta múltiplos métodos de autenticação: O full-archive search suporta apenas autenticação OAuth 2.0 App-Only.
Métricas privadas (non_public_metrics, organic_metrics, promoted_metrics) não estão disponíveis no full-archive search porque ele só suporta autenticação 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 apenas id, 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 o next_token da resposta para buscar páginas adicionais.

Como funciona

  1. Faça sua requisição inicial com max_results
  2. Verifique o objeto meta em busca de next_token
  3. Inclua next_token nas requisições subsequentes
  4. Repita até que nenhum next_token seja 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_ids conté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