Povolení vyhledávání X v API
Na této stránce
Přístup k datům z X v reálném čase
X Search je jedinečný vestavěný nástroj specifický pro API Grok. Umožňuje modelu vyhledávat příspěvky, profily a vlákna na síti X (dříve Twitter) v reálném čase. To dává Groku významnou konkurenční výhodu oproti ostatním API jazykových modelů, která obvykle nemají přímý přístup k sociálním sítím.
Možnosti X Search
X Search nabízí čtyři režimy vyhledávání:
- Vyhledávání podle klíčových slov: najdi příspěvky obsahující konkrétní výrazy
- Sémantické vyhledávání: najdi příspěvky týkající se daného tématu, i když neobsahují přesná slova
- Vyhledávání uživatelů: identifikuj relevantní profily
- Načítání vláken: získej přístup k úplným diskusním vláknům
Model automaticky zvolí režim nejvhodnější pro uživatelův požadavek.
Základní aktivace
Aktivace funguje stejně jako u Web Search. Do pole tools přidáš {"type": "x_search"}:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are developers saying about the latest React update?",
"tools": [
{"type": "x_search"}
]
}
Model automaticky vyhledá na síti X relevantní příspěvky a začlení je do své odpovědi včetně odpovídajících citací.
Aktivace přes SDK
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the reactions on X about Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Kombinace X Search a Web Search
Oba nástroje můžeš povolit současně, aby model křížově odkazoval informace z webu a sociálních sítí:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Model se sám rozhodne, který použít – nebo oba – na základě položené otázky. Dotaz na veřejné mínění upřednostní X Search, zatímco faktický dotaz favorizuje Web Search.
Klíčové rozdíly oproti Web Search
| Funkce | Web Search | X Search |
|---|---|---|
| Zdroj | Celý web | Pouze X/Twitter |
| Filtrování | Podle domény (max. 5) | Podle handle (max. 10) |
| Data | Nedostupná | from_date / to_date |
| Obrázky | enable_image_understanding | enable_image_understanding |
| Video | Nedostupné | enable_video_understanding |
| Cena | $5 / 1 000 volání | $5 / 1 000 volání |
Porozumění videu je výhradní funkcí X Search. Tato funkce umožňuje modelu analyzovat obsah videí zveřejněných na síti X.
Ceny platné k 5. srpnu 2026 – ceny se pravidelně mění: před výpočtem jakéhokoli rozpočtu si ověř aktuální ceník na oficiální stránce modelů a cen xAI.
Klíčové poznatky
- X Search je exkluzivní výhodou API Grok
- Aktivace probíhá pomocí
{"type": "x_search"}v politools - Čtyři režimy vyhledávání: klíčová slova, sémantika, uživatelé, vlákna
- Lze kombinovat s Web Search pro křížové odkazování informací
- Podporuje porozumění obrázkům i videu (exkluzivní funkce)