Ativar a Pesquisa X na API
Nesta página
Aceda a dados do X em tempo real
A Pesquisa X é uma ferramenta integrada exclusiva da API do Grok. Permite ao modelo procurar publicações, perfis e conversas no X (antigo Twitter) em tempo real. Isto confere ao Grok uma vantagem competitiva significativa face a outras APIs de modelos de linguagem, que normalmente não têm acesso direto às redes sociais.
Capacidades da Pesquisa X
A Pesquisa X oferece quatro modos de pesquisa:
- Pesquisa por palavras-chave: encontra publicações que contêm termos específicos
- Pesquisa semântica: encontra publicações relacionadas com um tópico, mesmo sem as palavras exatas
- Pesquisa de utilizadores: identifica perfis relevantes
- Recuperação de conversas: acede a fios de discussão completos
O modelo escolhe automaticamente o modo mais adequado ao pedido do utilizador.
Ativação básica
A ativação funciona da mesma forma que a Pesquisa Web. Adicione {"type": "x_search"} ao array tools:
{
"model": "grok-4.20-0309-reasoning",
"input": "O que dizem os programadores sobre a última atualização do React?",
"tools": [
{"type": "x_search"}
]
}
O modelo procura automaticamente no X publicações relevantes e integra-as na sua resposta, com as respetivas citações.
Ativação via SDK
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Quais são as reações no X sobre o Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Quais são as reações no X sobre o Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Combine a Pesquisa X e a Pesquisa Web
Pode ativar ambas as ferramentas em simultâneo para que o modelo cruze informações da web e das redes sociais:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
O modelo decide qual utilizar — ou ambas — com base na pergunta colocada. Uma questão sobre opinião pública favorece a Pesquisa X, enquanto uma questão factual favorece a Pesquisa Web.
Principais diferenças face à Pesquisa Web
| Funcionalidade | Pesquisa Web | Pesquisa X |
|---|---|---|
| Fonte | Toda a web | Apenas X/Twitter |
| Filtragem | Por domínio (máx. 5) | Por handle (máx. 10) |
| Datas | Indisponível | from_date / to_date |
| Imagens | enable_image_understanding | enable_image_understanding |
| Vídeo | Indisponível | enable_video_understanding |
| Custo | $5 / 1.000 chamadas | $5 / 1.000 chamadas |
A compreensão de vídeo é exclusiva da Pesquisa X. Esta funcionalidade permite ao modelo analisar o conteúdo de vídeos publicados no X.
Preços atualizados a 5 de agosto de 2026 — os preços alteram-se regularmente: antes de calcular qualquer orçamento, consulte a tabela de preços atualizada na página oficial de modelos e preços da xAI.
Pontos-chave
- A Pesquisa X é uma vantagem exclusiva da API do Grok
- A ativação utiliza
{"type": "x_search"}no arraytools - Quatro modos de pesquisa: palavras-chave, semântica, utilizadores, conversas
- Combinável com a Pesquisa Web para cruzar informações
- Suporta compreensão de imagens e vídeo (exclusivo)