Activarea căutării X pentru cercetare pe Twitter
Pe această pagină
Accesarea fluxului în timp real X prin API-ul dumneavoastră
X (fostul Twitter) rămâne platforma de referință pentru informațiile în timp real: anunțuri ale companiilor, reacții la știri, tendințe emergente și dezbateri publice. Instrumentul x_search din API-ul Grok vă permite să interogați acest flux direct din aplicațiile dumneavoastră, fără a fi nevoie de un abonament separat la API-ul X sau de gestionarea unor abonamente suplimentare.

În timp ce vechiul endpoint Chat Completions oferea un parametru sources: ["x"] în search_parameters, API-ul Responses pune la dispoziție un instrument dedicat, cu capacități de filtrare mult mai fine.
Activarea căutării X
Activarea funcționalității urmează același principiu ca și web_search. Adăugați instrumentul x_search în tabloul tools:
response = client.responses.create(
model="grok-4.5",
input="What are people saying about the AI Act on X today?",
tools=[{"type": "x_search"}]
)
print(response.output_text)
Modelul decide automat când să interogheze X, în funcție de natura solicitării dumneavoastră. Întrebările despre evenimente curente, opinia publică sau tendințe vor declanșa natural o căutare.
Cele patru capacități ale căutării X
Instrumentul x_search merge dincolo de simpla căutare după cuvinte-cheie. Oferă patru moduri de interogare:
- Căutare după cuvinte-cheie: găsirea postărilor care conțin termeni specifici
- Căutare semantică: găsirea postărilor legate de un concept, chiar și fără cuvintele exacte
- Căutare de utilizatori: identificarea conturilor relevante pe o temă dată
- Recuperarea firului de discuție: reconstrucția firelor de discuție complete
Modelul alege automat modul cel mai adecvat în funcție de cererea dumneavoastră. Nu este necesar să specificați explicit modul de utilizat.
Utilizarea cu diferite SDK-uri
xAI SDK (Python)
from xai_sdk.tools import x_search
response = client.chat.create(
model="grok-4.5",
tools=[x_search()]
)
Compatibil cu OpenAI SDK
response = client.responses.create(
model="grok-4.5",
input="Tech trends on X this week",
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 trends on X this week',
tools: [xai.tools.xSearch()]
});
Combinarea lui web_search și x_search
Puteți activa ambele instrumente simultan pentru a obține o imagine completă asupra unui subiect. Modelul va alege instrumentul cel mai relevant sau le va utiliza pe ambele, dacă este necesar:
response = client.responses.create(
model="grok-4.5",
input="Complete analysis of the latest Apple keynote",
tools=[
{"type": "web_search"},
{"type": "x_search"}
]
)
În acest caz, modelul poate căuta articole de presă prin web_search și reacții în timp real prin x_search, sintetizând apoi ambele perspective în răspunsul său.
Exercițiu practic
Creați un script care utilizează x_search pentru a monitoriza discuțiile din jurul unui subiect profesional care vă interesează. Testați cu interogări legate de evenimente curente și observați modul în care modelul sintetizează opiniile și faptele de pe X.
Puncte cheie
- Instrumentul
x_searchse activează cu{"type": "x_search"}în tabloultools - Suportă patru tipuri de căutare: cuvinte-cheie, semantică, utilizatori și fire de discuție
- Costul este identic cu cel al
web_search: 5 USD la 1.000 de apeluri - Ambele instrumente pot fi activate simultan pentru o acoperire completă
- Înțelegerea video este o exclusivitate
x_search(absentă dinweb_search)