Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Attivare X Search nelle API

Lezione 8 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Accedi ai dati di X in tempo reale
  2. Funzionalità di X Search
  3. Attivazione di base
  4. Attivazione tramite SDK
  5. Combina X Search e Web Search
  6. Differenze chiave rispetto alla Web Search
  7. Punti chiave

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.

𝕏
Ricerca nativa
10
Handle filtrabili
🎥
Video supportati
$5
/ 1.000 chiamate

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()]

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.

FunzionalitàWeb SearchX Search
FonteTutto il webSolo X/Twitter
FiltraggioPer dominio (max 5)Per handle (max 10)
DateNon disponibilifrom_date / to_date
Immaginienable_image_understandingenable_image_understanding
VideoNon disponibilienable_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’array tools
  • 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)