Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ativar a Pesquisa X na API

Aula 8 de 16 Atualizada a 30 de julho de 2026 Programador
Nesta página
  1. Aceda a dados do X em tempo real
  2. Capacidades da Pesquisa X
  3. Ativação básica
  4. Ativação via SDK
  5. Combine a Pesquisa X e a Pesquisa Web
  6. Principais diferenças face à Pesquisa Web
  7. Pontos-chave

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.

𝕏
Pesquisa nativa
10
Handles filtráveis
🎥
Vídeo suportado
$5
/ 1.000 chamadas

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

FuncionalidadePesquisa WebPesquisa X
FonteToda a webApenas X/Twitter
FiltragemPor domínio (máx. 5)Por handle (máx. 10)
DatasIndisponívelfrom_date / to_date
Imagensenable_image_understandingenable_image_understanding
VídeoIndisponívelenable_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 array tools
  • 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)