Attivare X Search nelle API
In questa pagina
Accedi ai dati di X in tempo reale
X Search è uno strumento integrato unico, specifico per le API di Grok. Consente al modello di cercare post, profili e thread su X (precedentemente Twitter) in tempo reale. Questo offre a Grok un vantaggio competitivo significativo rispetto ad altre API di modelli linguistici, che generalmente non hanno accesso diretto ai social network.
Funzionalità di X Search
X Search offre quattro modalità di ricerca:
- Ricerca per parole chiave: trova post contenenti termini specifici
- Ricerca semantica: trova post relativi a un argomento, anche senza parole esatte
- Ricerca utenti: identifica profili pertinenti
- Recupero thread: accedi a interi filoni di discussione
Il modello sceglie automaticamente la modalità più adatta alla richiesta dell’utente.
Attivazione di base
L’attivazione funziona come per la Web Search. Aggiungi {"type": "x_search"} all’array tools:
{
"model": "grok-4.20-0309-reasoning",
"input": "Cosa dicono gli sviluppatori sull'ultimo aggiornamento di React?",
"tools": [
{"type": "x_search"}
]
}
Il modello cerca automaticamente su X i post pertinenti e li integra nella sua risposta, con le relative citazioni.
Attivazione tramite SDK
xAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Quali sono le reazioni su X riguardo a Grok 4?",
tools=[client.tools.x_search()]
)
OpenAI SDK (Python)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Quali sono le reazioni su X riguardo a Grok 4?",
tools=[{"type": "x_search"}]
)
Vercel AI SDK (JavaScript)
tools: [xai.tools.xSearch()]
Combina X Search e Web Search
Puoi abilitare entrambi gli strumenti contemporaneamente, permettendo al modello di incrociare informazioni dal web e dai social network:
{
"tools": [
{"type": "web_search"},
{"type": "x_search"}
]
}
Il modello decide quale utilizzare, o entrambi, in base alla domanda posta. Una domanda sull’opinione pubblica favorisce X Search, mentre una domanda fattuale privilegia la Web Search.
Differenze chiave rispetto alla Web Search
| Funzionalità | Web Search | X Search |
|---|---|---|
| Fonte | Tutto il web | Solo X/Twitter |
| Filtraggio | Per dominio (max 5) | Per handle (max 10) |
| Date | Non disponibili | from_date / to_date |
| Immagini | enable_image_understanding | enable_image_understanding |
| Video | Non disponibili | enable_video_understanding |
| Costo | $5 / 1.000 chiamate | $5 / 1.000 chiamate |
La comprensione video è esclusiva di X Search. Questa funzione permette al modello di analizzare il contenuto dei video pubblicati su X.
Prezzi aggiornati al 5 agosto 2026 — i prezzi cambiano regolarmente: prima di calcolare qualsiasi budget, consulta la tabella dei prezzi attuale sulla pagina ufficiale dei modelli e dei prezzi di xAI.
Punti chiave
- X Search è un vantaggio esclusivo delle API di Grok
- L’attivazione utilizza
{"type": "x_search"}nell’arraytools - Quattro modalità di ricerca: parole chiave, semantica, utenti, thread
- Combinabile con la Web Search per incrociare le informazioni
- Supporta la comprensione di immagini e video (esclusiva)