Activer X Search dans l'API — Outils intégrés : Web, X, Code

Accéder aux données de X en temps réel

X Search est un outil intégré unique à l’API Grok. Il permet au modèle de rechercher des posts, des profils et des threads sur X (anciennement Twitter) en temps réel. C’est un avantage compétitif majeur de Grok par rapport aux autres API de modèles de langage, qui n’ont généralement pas d’accès direct aux réseaux sociaux.

𝕏

Recherche native

Handles filtrables

🎥

Vidéo supportée

/ 1 000 appels

Capacités de X Search

X Search offre quatre modes de recherche :

Recherche par mots-clés : trouver des posts contenant des termes spécifiques
Recherche sémantique : trouver des posts liés à un sujet, même sans les mots exacts
Recherche d’utilisateurs : identifier des profils pertinents
Récupération de threads : accéder aux fils de discussion complets

Le modèle choisit automatiquement le mode le plus adapté à la requête de l’utilisateur.

Activation basique

L’activation suit le même principe que Web Search. Vous ajoutez {"type": "x_search"} au tableau tools :

{
  "model": "grok-4.20-reasoning",
  "input": "Que disent les développeurs sur la dernière mise à jour de React ?",
  "tools": [
    {"type": "x_search"}
  ]
}

Le modèle recherchera automatiquement sur X les posts pertinents et les intégrera dans sa réponse, avec les citations correspondantes.

Activation par SDK

xAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Quelles sont les réactions sur X à propos de Grok 4 ?",
    tools=[client.tools.x_search()]
)

OpenAI SDK (Python)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Quelles sont les réactions sur X à propos de Grok 4 ?",
    tools=[{"type": "x_search"}]
)

Vercel AI SDK (JavaScript)

tools: [xai.tools.xSearch()]

Combiner X Search et Web Search

Vous pouvez activer les deux outils simultanément pour que le modèle croise les informations du web et des réseaux sociaux :

{
  "tools": [
    {"type": "web_search"},
    {"type": "x_search"}
  ]
}

Le modèle décidera lequel utiliser — ou les deux — en fonction de la question posée. Une question sur l’opinion publique favorisera X Search, tandis qu’une question factuelle favorisera Web Search.

Différences clés avec Web Search

Caractéristique	Web Search	X Search
Source	Web entier	X/Twitter uniquement
Filtrage	Par domaines (5 max)	Par handles (10 max)
Dates	Non disponible	`from_date` / `to_date`
Images	`enable_image_understanding`	`enable_image_understanding`
Vidéo	Non disponible	`enable_video_understanding`
Coût	$5 / 1 000 appels	$5 / 1 000 appels

La compréhension vidéo est une exclusivité de X Search. Cette fonctionnalité permet au modèle d’analyser le contenu des vidéos publiées sur X.

Points clés à retenir

X Search est un avantage exclusif de l’API Grok
L’activation se fait avec {"type": "x_search"} dans le tableau tools
Quatre modes de recherche : mots-clés, sémantique, utilisateurs, threads
Combinable avec Web Search pour croiser les informations
Supporte la compréhension d’images et de vidéos (exclusivité)