Ativar a Pesquisa X para Investigação no Twitter
Nesta página
Aceda ao Feed em Tempo Real do X através da sua API
O X (anteriormente Twitter) continua a ser a plataforma de referência para informação em tempo real: anúncios de empresas, reações a notícias, tendências emergentes e debates públicos. A ferramenta x_search da API Grok permite-lhe consultar este feed diretamente a partir das suas aplicações, sem necessidade de uma subscrição separada da API X ou de gerir subscrições adicionais.

Enquanto o antigo endpoint Chat Completions oferecia o parâmetro sources: ["x"] em search_parameters, a API Responses fornece uma ferramenta dedicada com capacidades de filtragem muito mais refinadas.
Ativar a Pesquisa X
A ativação segue o mesmo princípio da web_search. Basta adicionar a ferramenta x_search ao array tools:
response = client.responses.create(
model="grok-4.5",
input="O que dizem as pessoas sobre a Lei da IA no X hoje?",
tools=[{"type": "x_search"}]
)
print(response.output_text)
O modelo decide automaticamente quando consultar o X com base na natureza do seu prompt. Perguntas sobre acontecimentos atuais, opinião pública ou tendências desencadearão naturalmente a pesquisa.
As Quatro Capacidades da Pesquisa X
A ferramenta x_search vai além da simples pesquisa por palavras-chave. Oferece quatro modos de consulta:
- Pesquisa por palavras-chave: encontra publicações que contêm termos específicos
- Pesquisa semântica: encontra publicações relacionadas com um conceito, mesmo sem as palavras exatas
- Pesquisa de utilizadores: identifica contas relevantes sobre um tópico
- Recuperação de threads: reconstrói fios de discussão completos
O modelo escolhe automaticamente o modo mais adequado com base no seu pedido. Não precisa de especificar explicitamente qual o modo a utilizar.
Utilização com Diferentes SDKs
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
SDK Compatível com OpenAI
response = client.responses.create(
model="grok-4.5",
input="Tendências tecnológicas no X esta semana",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
import { xai } from '@ai-sdk/xai';
const response = await generateText({
model: xai.responses('grok-4.5'),
prompt: 'Tech trends on X this week',
tools: [xai.tools.xSearch()]
});
Combinar web_search e x_search
Pode ativar ambas as ferramentas simultaneamente para obter uma visão completa de um tópico. O modelo escolherá a ferramenta mais relevante ou utilizará ambas, se necessário:
response = client.responses.create(
model="grok-4.5",
input="Análise completa da mais recente keynote da Apple",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
Neste caso, o modelo poderá pesquisar artigos de imprensa através da web_search e reações em tempo real através da x_search, sintetizando depois ambas as perspetivas na sua resposta.
Prática Guiada
Crie um script que utilize a x_search para monitorizar discussões em torno de um tópico profissional que lhe interesse. Teste com consultas sobre acontecimentos atuais e observe como o modelo sintetiza opiniões e factos do X.
Pontos-chave
- A ferramenta
x_searché ativada com{"type": "x_search"}no arraytools - Suporta quatro tipos de pesquisa: palavras-chave, semântica, utilizadores e threads
- O custo é idêntico ao da
web_search: $5 por 1.000 chamadas - Ambas as ferramentas podem ser ativadas simultaneamente para uma cobertura completa
- A compreensão de vídeo é exclusiva da
x_search(ausente naweb_search)