Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Attiva la ricerca X per le tue ricerche su Twitter

Lezione 5 di 14 Aggiornata il 30 luglio 2026 Principiante
In questa pagina
  1. Accedi al feed in tempo reale di X dalla tua API
  2. Attivare la ricerca X
  3. Le quattro capacità della ricerca X
  4. Utilizzo con diversi SDK
  5. Combina web_search e x_search
  6. Esercitazione pratica
  7. Punti chiave

Accedi al feed in tempo reale di X dalla tua API

X (ex Twitter) rimane la piattaforma di riferimento per le informazioni in tempo reale: annunci aziendali, reazioni alle notizie, trend emergenti e dibattiti pubblici. Lo strumento x_search delle API di Grok ti permette di interrogare direttamente questo feed dalle tue applicazioni, senza bisogno di un abbonamento separato alle API di X o di gestire sottoscrizioni aggiuntive.

Ricerca X con Grok

Mentre il vecchio endpoint Chat Completions offriva un parametro sources: ["x"] in search_parameters, le API Responses forniscono uno strumento dedicato con capacità di filtraggio molto più fini.

10
handle filtrabili
4
tipi di ricerca
$5
per 1.000 chiamate
Video
analisi esclusiva

Attivare la ricerca X

L’attivazione segue lo stesso principio di web_search. Aggiungi lo strumento x_search all’array tools:

response = client.responses.create(
    model="grok-4.5",
    input="Cosa dice la gente sull'AI Act su X oggi?",
    tools=[{"type": "x_search"}]
)

print(response.output_text)

Il modello decide automaticamente quando interrogare X in base alla natura del tuo prompt. Le domande su eventi attuali, opinione pubblica o trend attiveranno naturalmente la ricerca.

Le quattro capacità della ricerca X

Lo strumento x_search va oltre la semplice ricerca per parole chiave. Offre quattro modalità di interrogazione:

  • Ricerca per parole chiave: trova post contenenti termini specifici
  • Ricerca semantica: trova post relativi a un concetto, anche senza le parole esatte
  • Ricerca per utente: identifica account pertinenti su un argomento
  • Recupero thread: ricostruisce interi filoni di discussione

Il modello sceglie automaticamente la modalità più appropriata in base alla tua richiesta. Non hai bisogno di specificare esplicitamente quale modalità utilizzare.

Utilizzo con diversi SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

response = client.chat.create(
    model="grok-4.5",
    tools=[x_search()]
)

Compatibile con OpenAI SDK

response = client.responses.create(
    model="grok-4.5",
    input="Trend tecnologici su X questa settimana",
    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: 'Trend tecnologici su X questa settimana',
  tools: [xai.tools.xSearch()]
});

Puoi abilitare entrambi gli strumenti simultaneamente per ottenere una visione completa di un argomento. Il modello sceglierà lo strumento più pertinente o li utilizzerà entrambi se necessario:

response = client.responses.create(
    model="grok-4.5",
    input="Analisi completa dell'ultimo keynote Apple",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

In questo caso, il modello potrebbe cercare articoli stampa tramite web_search e reazioni in tempo reale tramite x_search, per poi sintetizzare entrambe le prospettive nella sua risposta.

Esercitazione pratica

Crea uno script che utilizzi x_search per monitorare le discussioni intorno a un argomento professionale che ti interessa. Prova con query su eventi attuali e osserva come il modello sintetizza opinioni e fatti provenienti da X.

Punti chiave

  • Lo strumento x_search si attiva con {"type": "x_search"} nell’array tools
  • Supporta quattro tipi di ricerca: parole chiave, semantica, utenti e thread
  • Il costo è identico a web_search: $5 per 1.000 chiamate
  • Entrambi gli strumenti possono essere abilitati simultaneamente per una copertura completa
  • La comprensione video è un’esclusiva di x_search (assente in web_search)