Az X keresés engedélyezése Twitter-kutatáshoz
Ezen az oldalon
Az X valós idejű hírfolyamának elérése az API-dból
Az X (korábban Twitter) továbbra is a legmegbízhatóbb platform a valós idejű információkhoz: vállalati bejelentések, hírekre adott reakciók, feltörekvő trendek és nyilvános viták. A Grok API x_search eszköze lehetővé teszi, hogy közvetlenül lekérdezd ezt a hírfolyamot az alkalmazásaidból, anélkül, hogy külön X API-előfizetésre lenne szükséged, vagy további előfizetéseket kellene kezelned.

Míg a régi Chat Completions végpont a search_parameters között egy sources: ["x"] paramétert kínált, addig a Responses API egy dedikált eszközt biztosít, sokkal finomabb szűrési lehetőségekkel.
Az X keresés engedélyezése
Az engedélyezés ugyanazon az elven működik, mint a web_search esetében. Hozzáadod az x_search eszközt a tools tömbhöz:
response = client.responses.create(
model="grok-4.5",
input="Mit mondanak az emberek ma az AI-törvényről az X-en?",
tools=[{"type": "x_search"}]
)
print(response.output_text)
A modell automatikusan eldönti, mikor kérdezze le az X-et az utasításod jellege alapján. A current eseményekre, a közvéleményre vagy a trendekre vonatkozó kérdések természetesen keresést indítanak el.
Az X keresés négy képessége
Az x_search eszköz túlmutat az egyszerű kulcsszavas keresésen. Négy lekérdezési módot kínál:
- Kulcsszavas keresés: konkrét kifejezéseket tartalmazó bejegyzések megtalálása
- Szemantikai keresés: egy fogalomhoz kapcsolódó bejegyzések megtalálása, még akkor is, ha nem szerepelnek benne a pontos szavak
- Felhasználói keresés: releváns fiókok azonosítása egy témában
- Szálak lekérése: teljes beszélgetési szálak rekonstruálása
A modell az kérésed alapján automatikusan kiválasztja a legmegfelelőbb módot. Nem kell explicit módon megadnod, melyik módot használja.
Használat különböző SDK-kkal
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
OpenAI SDK kompatibilis
response = client.responses.create(
model="grok-4.5",
input="Tech trendek az X-en ezen a héten",
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 trendek az X-en ezen a héten',
tools: [xai.tools.xSearch()]
});
A web_search és az x_search kombinálása
Egyszerre is engedélyezheted mindkét eszközt, hogy teljes képet kapj egy témáról. A modell kiválasztja a legrelevánsabb eszközt, vagy szükség esetén mindkettőt használja:
response = client.responses.create(
model="grok-4.5",
input="A legutóbbi Apple keynote teljes elemzése",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
Ebben az esetben a modell sajtócikkeket kereshet a web_search segítségével, valós idejű reakciókat pedig az x_search révén, majd válaszában szintetizálja mindkét nézőpontot.
Gyakorlati feladat
Készíts egy szkriptet, amely az x_search használatával figyeli az érdeklődési körödbe tartozó szakmai téma körüli beszélgetéseket. Teszteld aktuális eseményekre vonatkozó lekérdezésekkel, és figyeld meg, hogyan szintetizálja a modell az X-ről származó véleményeket és tényeket.
Főbb megállapítások
- Az
x_searcheszköz atoolstömbben a{"type": "x_search"}beállítással aktiválódik - Négy keresési típust támogat: kulcsszavas, szemantikai, felhasználói és szálak
- A költség megegyezik a
web_searchével: 1000 hívásonként 5 USD - Mindkét eszköz egyszerre is engedélyezhető a teljes lefedettség érdekében
- A videóértés az
x_searchexkluzív funkciója (nem elérhető aweb_searchesetén)