Salt la conținutul principal
Română— Alege o limbă
Meniu

Activarea căutării X în API

Lecția 8 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. Accesarea datelor X în timp real
  2. Capacitățile Căutării X
  3. Activarea de bază
  4. Activarea prin SDK
  5. Combinarea Căutării X cu Căutarea Web
  6. Diferențe cheie față de Căutarea Web
  7. Puncte cheie

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.

𝕏
Căutare nativă
10
Handle-uri filtrabile
🎥
Video suportat
$5
/ 1.000 de apeluri

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 WebCăutare X
SursăÎntregul webDoar X/Twitter
FiltrareDupă domeniu (maxim 5)După handle (maxim 10)
DateIndisponibilefrom_date / to_date
Imaginienable_image_understandingenable_image_understanding
VideoIndisponibilenable_video_understanding
Cost5 $ / 1.000 de apeluri5 $ / 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 tabloul tools
  • 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)