Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Ota X-haku käyttöön rajapinnassa

Oppitunti 8 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Käytä X:n dataa reaaliajassa
  2. X-haun ominaisuudet
  3. Peruskäyttöönotto
  4. SDK-käyttöönotto
  5. Yhdistä X-haku ja verkkohaku
  6. Keskeiset erot verkkohakuun verrattuna
  7. Keskeiset asiat

Käytä X:n dataa reaaliajassa

X-haku on ainutlaatuinen, sisäänrakennettu työkalu, joka on tarkoitettu nimenomaan Grok-rajapinnalle. Se antaa mallin hakea viestejä, profiileja ja keskusteluketjuja X:stä (entinen Twitter) reaaliajassa. Tämä tarjoaa Grokille merkittävän kilpailuedun muihin kielimalleihin verrattuna, sillä niillä ei yleensä ole suoraa pääsyä sosiaalisiin verkkoihin.

𝕏
Native search
10
Filterable handles
🎥
Video supported
$5
/ 1,000 calls

X-haun ominaisuudet

X-haku tarjoaa neljä hakutilaa:

  • Avainsanahaku: löytää viestejä, jotka sisältävät tiettyjä termejä
  • Semanttinen haku: löytää aiheeseen liittyviä viestejä, vaikka tarkkoja sanoja ei käytettäisi
  • Käyttäjähaku: tunnistaa asiaankuuluvia profiileja
  • Ketjujen nouto: pääsy kokonaisiin keskusteluketjuihin

Malli valitsee automaattisesti käyttäjän pyyntöön parhaiten sopivan tilan.

Peruskäyttöönotto

Käyttöönotto toimii samalla tavalla kuin verkkohaku. Lisäät {"type": "x_search"} kohdan tools-taulukkoon:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "What are developers saying about the latest React update?",
  "tools": [
    {"type": "x_search"}
  ]
}

Malli hakee automaattisesti X:stä asiaankuuluvia viestejä ja sisällyttää ne vastaukseensa asianmukaisin viittauksin.

SDK-käyttöönotto

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

Yhdistä X-haku ja verkkohaku

Voit ottaa molemmat työkalut käyttöön samanaikaisesti, jolloin malli voi ristiviitata tietoja verkosta ja sosiaalisista verkostoista:

{
  "tools": [
    {"type": "web_search"},
    {"type": "x_search"}
  ]
}

Malli päättää kumpaa käyttää – tai käyttääkö molempia – esitetyn kysymyksen perusteella. Yleiseen mielipiteeseen liittyvä kysymys suosii X-hakua, kun taas faktuaalinen kysymys suosii verkkohakua.

Keskeiset erot verkkohakuun verrattuna

OminaisuusVerkkohakuX-haku
LähdeKoko verkkoVain X/Twitter
SuodatusVerkkotunnuksen mukaan (max 5)Käyttäjätunnuksen mukaan (max 10)
PäivämäärätEi saatavillafrom_date / to_date
Kuvatenable_image_understandingenable_image_understanding
VideoEi saatavillaenable_video_understanding
Hinta5 $ / 1 000 pyyntöä5 $ / 1 000 pyyntöä

Videoiden ymmärtäminen on yksinomaan X-haun ominaisuus. Tämä toiminto antaa mallille mahdollisuuden analysoida X:ään ladattujen videoiden sisältöä.

Hinnoittelu 5.8.2026 alkaen – hinnat muuttuvat säännöllisesti: ennen budjetin laskemista tarkista ajantasainen hintataulukko xAI:n viralliselta mallit ja hinnoittelu -sivulta.

Keskeiset asiat

  • X-haku on Grok-rajapinnan yksinoikeus
  • Käyttöönotto tapahtuu lisäämällä {"type": "x_search"} kohtaan tools
  • Neljä hakutilaa: avainsanat, semanttinen haku, käyttäjät, ketjut
  • Yhdistettävissä verkkohakuun tietojen ristiviittaamiseksi
  • Tukee kuvien ja videoiden ymmärtämistä (yksinoikeus)