/search-tweets consulta o índice público de busca do X e retorna publicações com perfis completos dos autores e métricas de engajamento. Veja fluxos completos, modelos de consulta e código no guia de busca de publicações, no blog.
Endpoint
Autenticação
Envie a chave no cabeçalhoApiKey. O nome do cabeçalho não diferencia maiúsculas de minúsculas; o valor deve ser exatamente o da chave emitida.
Corpo da requisição
Exemplo
Resposta
Operadores
O campoquery aceita os operadores nativos do X:
- Palavras e frases exatas:
"climate change". - Usuários:
from:,to:,@mention. - Engajamento:
min_faves:,min_retweets:,min_replies:. - Conteúdo:
filter:media,filter:images,filter:videos,filter:links; use-para excluir. - Idioma e data:
lang:en,since:2026-01-01,until:2026-03-01. - Lógica booleana:
OR, parênteses e-.
Paginação
Repita a mesma consulta com onext_cursor retornado. Quando ele for nulo ou ausente, os resultados terminaram. Veja paginação.
Limite de requisições
20 requisições por segundo por chave em todos os planos padrão. O excesso retorna429 Too Many Requests. Veja limites.
Códigos de erro
Veja códigos de erro.
Endpoints relacionados
- Menções: monitoramento de
@handlecom filtros no corpo. - Publicações de usuário: timeline de uma conta.
- Busca de usuários: contas por palavra-chave.