Activarea căutării X în API
Pe această pagină
Accesarea datelor X în timp real
Căutarea X (X Search) este un instrument integrat unic, specific API-ului Grok. Acesta permite modelului să caute postări, profiluri și fire de discuție (threads) pe X (fostul Twitter) în timp real. Aceasta oferă lui Grok un avantaj competitiv semnificativ față de alte API-uri de modele lingvistice, care nu au acces direct la rețelele sociale.
Capacitățile Căutării X
Căutarea X oferă patru moduri de căutare:
- Căutare după cuvinte cheie: găsiți postări care conțin termeni specifici
- Căutare semantică: găsiți postări legate de un subiect, chiar și fără cuvintele exacte
- Căutare de utilizatori: identificați profiluri relevante
- Recuperarea firelor de discuție: accesați fire complete de conversație
Modelul alege automat modul cel mai potrivit pentru cererea utilizatorului.
Activarea de bază
Activarea funcționează la fel ca în cazul Căutării Web. Adăugați {"type": "x_search"} în tabloul tools:
{
"model": "grok-4.20-0309-reasoning",
"input": "Ce spun dezvoltatorii despre ultima actualizare React?",
"tools": [
{"type": "x_search"}
]
}
Modelul caută automat pe X postările relevante și le integrează în răspunsul său, împreună cu citările corespunzătoare.
Activarea prin SDK
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Care sunt reacțiile pe X despre Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Care sunt reacțiile pe X despre Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Combinarea Căutării X cu Căutarea Web
Puteți activa ambele instrumente simultan, astfel încât modelul să coreleze informațiile de pe web cu cele din rețelele sociale:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Modelul decide pe care să îl utilizeze – sau pe ambele – în funcție de întrebarea pusă. O întrebare despre opinia publică favorizează Căutarea X, în timp ce o întrebare factuală favorizează Căutarea Web.
Diferențe cheie față de Căutarea Web
| Caracteristică | Căutare Web | Căutare X |
|---|---|---|
| Sursă | Întregul web | Doar X/Twitter |
| Filtrare | După domeniu (maxim 5) | După handle (maxim 10) |
| Date | Indisponibile | from_date / to_date |
| Imagini | enable_image_understanding | enable_image_understanding |
| Video | Indisponibil | enable_video_understanding |
| Cost | 5 $ / 1.000 de apeluri | 5 $ / 1.000 de apeluri |
Înțelegerea video este exclusivă Căutării X. Această funcție permite modelului să analizeze conținutul videoclipurilor postate pe X.
Prețuri valabile la 5 august 2026 — prețurile se modifică regulat: înainte de a calcula orice buget, verificați tabelul actual de prețuri pe pagina oficială a modelelor și prețurilor xAI.
Puncte cheie
- Căutarea X este un avantaj exclusiv al API-ului Grok
- Activarea se face folosind
{"type": "x_search"}în tabloultools - Patru moduri de căutare: cuvinte cheie, semantic, utilizatori, fire de discuție
- Poate fi combinată cu Căutarea Web pentru corelarea informațiilor
- Suportă înțelegerea imaginilor și a videoclipurilor (exclusiv)