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

Ativar a Pesquisa X para Investigação no Twitter

Aula 5 de 14 Atualizada a 30 de julho de 2026 Iniciante
Nesta página
  1. Aceda ao Feed em Tempo Real do X através da sua API
  2. Ativar a Pesquisa X
  3. As Quatro Capacidades da Pesquisa X
  4. Utilização com Diferentes SDKs
  5. Combinar web_search e x_search
  6. Prática Guiada
  7. Pontos-chave

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.

Pesquisa X com Grok

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.

10
handles filtráveis
4
tipos de pesquisa
$5
por 1.000 chamadas
Vídeo
análise exclusiva

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()]
});

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 array tools
  • 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 na web_search)