X Search'i API-s lubamine
Sellel lehel
Ligipääs X-i andmetele reaalajas
X Search on Grok API-le omane ainulaadne sisseehitatud tööriist. See võimaldab mudelil otsida reaalajas postitusi, profiile ja lõngu platvormil X (varem Twitter). See annab Grokile märkimisväärse eelise teiste keelemudelite API-de ees, millel tavaliselt puudub otsene ligipääs sotsiaalvõrgustikele.
X Search’i võimalused
X Search pakub nelja otsingurežiimi:
- Märksõnaotsing: leiab postitusi, mis sisaldavad konkreetseid termineid
- Semantiline otsing: leiab teemaga seotud postitusi, isegi kui täpsed sõnad puuduvad
- Kasutajaotsing: tuvastab asjakohased profiilid
- Lõngude toomine: annab juurdepääsu terviklikele arutelulõngadele
Mudel valib automaatselt kasutaja päringule kõige sobivama režiimi.
Põhiline aktiveerimine
Aktiveerimine toimib samamoodi nagu veebiotsingu (Web Search) puhul. Lisa massiivi tools objekt {"type": "x_search"}:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are developers saying about the latest React update?",
"tools": [
{"type": "x_search"}
]
}
Mudel otsib automaatselt X-ist asjakohaseid postitusi ja lõimib need koos vastavate viidetega oma vastusesse.
SDK aktiveerimine
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()]
Kombineeri X Search ja veebiotsing
Saad mõlemad tööriistad samaaegselt lubada, et mudel saaks ristviidata teavet veebist ja sotsiaalvõrgustikest:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Mudel otsustab küsimuse põhjal, kumbat kasutada – või mõlemat. Avaliku arvamuse kohta käiv küsimus eelistab X Search’i, samas kui faktiline küsimus eelistab veebiotsingut.
Peamised erinevused veebiotsingust
| Omadus | Veebiotsing | X Search |
|---|---|---|
| Allikas | Kogu veeb | Ainult X/Twitter |
| Filtreerimine | Domeeni järgi (max 5) | Kasutajanime järgi (max 10) |
| Kuupäevad | Pole saadaval | from_date / to_date |
| Pildid | enable_image_understanding | enable_image_understanding |
| Video | Pole saadaval | enable_video_understanding |
| Hind | 5 $ / 1000 päringut | 5 $ / 1000 päringut |
Video mõistmine on eranditult X Search’i funktsioon. See võimaldab mudelil analüüsida X-i postitatud videote sisu.
Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve koostamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.
Peamised punktid
- X Search on Grok API eksklusiivne eelis
- Aktiveerimiseks lisa massiivi
toolsväärtus{"type": "x_search"} - Neli otsingurežiimi: märksõnad, semantika, kasutajad, lõngud
- Kombineeritav veebiotsinguga teabe ristviitamiseks
- Toetab piltide ja videote mõistmist (eksklusiivne)