Skip to main content
/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çalho ApiKey. O nome do cabeçalho não diferencia maiúsculas de minúsculas; o valor deve ser exatamente o da chave emitida.
Veja autenticação.

Corpo da requisição

Exemplo

Resposta

Cada publicação inclui o perfil completo do autor. Não é necessária outra consulta para obter seus dados. Veja os campos em formato de resposta.

Operadores

O campo query 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 -.
Consulte a referência de operadores de busca.

Paginação

Repita a mesma consulta com o next_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 retorna 429 Too Many Requests. Veja limites.

Códigos de erro

Veja códigos de erro.

Endpoints relacionados