Aktivace vyhledávání X pro výzkum na Twitteru
Na této stránce
Přístup k živému kanálu X přímo z tvého API
X (dříve Twitter) zůstává hlavní platformou pro získávání informací v reálném čase: oznámení firem, reakce na zprávy, nastupující trendy a veřejné debaty. Nástroj x_search v API Grok ti umožňuje dotazovat se na tento kanál přímo z tvých aplikací, aniž bys potřeboval samostatné předplatné X API nebo spravoval další služby.

Zatímco zastaralý koncový bod Chat Completions nabízel parametr sources: ["x"] v rámci search_parameters, API Responses poskytuje vyhrazený nástroj s mnohem jemnějšími možnostmi filtrování.
Aktivace vyhledávání na X
Aktivace funguje na stejném principu jako web_search. Do pole tools jednoduše přidáš nástroj x_search:
response = client.responses.create(
model="grok-4.5",
input="What are people saying about the AI Act on X today?",
tools=[{"type": "x_search"}]
)
print(response.output_text)
Model se automaticky rozhodne, kdy má X prohledat, na základě povahy tvého dotazu. Otázky týkající se aktuálního dění, veřejného mínění nebo trendů přirozeně spustí vyhledávání.
Čtyři schopnosti vyhledávání na X
Nástroj x_search jde nad rámec prostého hledání klíčových slov. Nabízí čtyři režimy dotazů:
- Hledání klíčových slov: najdi příspěvky obsahující konkrétní výrazy
- Sémantické hledání: najdi příspěvky související s konceptem, i když neobsahují přesná slova
- Hledání uživatelů: identifikuj relevantní účty k danému tématu
- Načítání vláken: rekonstruuj kompletní diskusní vlákna
Model automaticky zvolí nejvhodnější režim na základě tvého požadavku. Nemusíš explicitně specifikovat, který režim použít.
Použití s různými SDK
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
Kompatibilní s OpenAI SDK
response = client.responses.create(
model="grok-4.5",
input="Tech trends on X this week",
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()]
});
Kombinace web_search a x_search
Oba nástroje můžeš aktivovat současně, abys získal úplný přehled o daném tématu. Model zvolí ten nejrelevantnější nástroj, nebo v případě potřeby využije oba:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
V tomto případě může model vyhledat tiskové články prostřednictvím web_search a reakce v reálném čase prostřednictvím x_search, následně oba pohledy syntetizovat ve své odpovědi.
Praktické cvičení
Vytvoř skript, který využívá x_search k monitorování diskusí kolem profesního tématu, které tě zajímá. Otestuj dotazy na aktuální události a sleduj, jak model syntetizuje názory a fakta z platformy X.
Klíčové poznatky
- Nástroj
x_searchse aktivuje pomocí{"type": "x_search"}v politools - Podporuje čtyři typy hledání: klíčová slova, sémantické, uživatele a vlákna
- Cena je totožná s
web_search: 5 $ za 1 000 volání - Obě nástroje lze aktivovat současně pro úplné pokrytí
- Porozumění videu je výhradní funkcí
x_search(vweb_searchchybí)