Activer X Search pour la Recherche sur Twitter

Accéder au flux temps réel de X depuis votre API

X (anciennement Twitter) reste la plateforme de référence pour l’information en temps réel : annonces d’entreprises, réactions à l’actualité, tendances émergentes, débats publics. L’outil x_search de l’API Grok vous permet d’interroger ce flux directement depuis vos applications, sans passer par l’API X séparée ni gérer des abonnements supplémentaires.

Là où l’ancien endpoint Chat Completions proposait un paramètre sources: ["x"] dans les search_parameters, l’API Responses offre un outil dédié avec des capacités de filtrage bien plus fines.

Activer la recherche X

L’activation suit le même principe que web_search. Vous ajoutez l’outil x_search au tableau tools :

response = client.responses.create(
    model="grok-3",
    input="Que dit-on de l'IA Act sur X aujourd'hui ?",
    tools=[{"type": "x_search"}]
)

print(response.output_text)

Le modèle décide automatiquement quand interroger X en fonction de la nature de votre prompt. Les questions d’actualité, d’opinion publique ou de tendances déclencheront naturellement la recherche.

Les quatre capacités de X Search

L’outil x_search va au-delà de la simple recherche par mots-clés. Il propose quatre modes d’interrogation :

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

Le modèle choisit automatiquement le mode le plus approprié selon votre requête. Vous n’avez pas à spécifier explicitement quel mode utiliser.

Utilisation avec les différents SDK

xAI SDK (Python)

from xai_sdk.tools import x_search

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

OpenAI SDK compatible

response = client.responses.create(
    model="grok-3",
    input="Tendances tech sur X cette semaine",
    tools=[{"type": "x_search"}]
)

Vercel AI SDK (JavaScript)

import { xai } from '@ai-sdk/xai';

const response = await generateText({
  model: xai.responses('grok-3'),
  prompt: 'Tendances tech sur X cette semaine',
  tools: [xai.tools.xSearch()]
});

Combiner web_search et x_search

Vous pouvez activer les deux outils simultanément pour obtenir une vue complète d’un sujet. Le modèle choisira l’outil le plus pertinent, ou utilisera les deux si nécessaire :

response = client.responses.create(
    model="grok-3",
    input="Analyse complète de la dernière keynote Apple",
    tools=[
        {"type": "web_search"},
        {"type": "x_search"}
    ]
)

Dans ce cas, le modèle pourrait chercher les articles de presse via web_search et les réactions en temps réel via x_search, puis synthétiser les deux perspectives dans sa réponse.

Mise en pratique

Créez un script qui utilise x_search pour surveiller les discussions autour d’un sujet professionnel qui vous intéresse. Testez avec des requêtes d’actualité et observez comment le modèle synthétise les opinions et les faits issus de X.

Points clés à retenir

• L’outil x_search s’active avec {"type": "x_search"} dans le tableau tools
• Il supporte quatre types de recherche : mots-clés, sémantique, utilisateurs et threads
• Le coût est identique à web_search : 5 $ pour 1 000 appels
• Les deux outils peuvent être activés simultanément pour une couverture complète
• La compréhension vidéo est une exclusivité de x_search (absente de web_search)