Aller au contenu

Moteurs IA

Grok Live Search dans l'API de xAI : les outils qui l'ont remplacé

Live Search a été retiré : une requête qui pose search_parameters échoue. L'outil web_search a pris la suite, à 5 $ les 1 000 appels, jetons en plus.

Cube bleu isométrique et petites tuiles posés près de deux panneaux blancs reliés par un tracé courbe

Consultant SEO, et plus récemment GEO, chez MentionBox

Live Search, la première fonction de recherche en temps réel livrée par xAI sur son API, ne répond plus. L'objet search_parameters de POST /v1/chat/completions est marqué déprécié dans la description OpenAPI de xAI, qui indique que la recherche en direct a été retirée et que les requêtes posant ce champ échouent, et les développeurs restés sur l'ancienne forme rapportent une erreur HTTP 410 dont le corps indique « Live search is deprecated. Please switch to the Agent Tools API ». La suite est assurée par deux outils exécutés côté serveur, déclarés dans le tableau tools d'un appel à la Responses API, web_search et x_search, facturés 5 $ les 1 000 appels de recherche web en plus des jetons servis à Grok.

Cette page s'adresse au développeur dont le code Live Search s'est mis à échouer, et à qui veut chiffrer un budget autour de la recherche de Grok avant d'écrire l'intégration. Au programme : les endroits où la documentation se contredit encore, la requête qui fonctionne aujourd'hui, l'emplacement des citations, le prix d'une réponse avec recherche, et ce que les outils laissent à votre charge.

Le retrait, et ce que dit encore la doc

Les notes de version de xAI portent une seule entrée Live Search, datée de mai 2025 : « Live Search is available on API ». Aucune entrée de retrait ne la suit, alors que cette même page annonce des dépréciations et des dates de fin de vie pour les modèles de voix et d'image. Trois éléments se contredisent désormais, et c'est pour cela que la question revient :

  • L'ancienne adresse du guide survit avec un autre contenu. docs.x.ai/docs/guides/live-search renvoie une page intitulée Web Search, qui documente l'outil de remplacement : un favori de 2025 semble donc vivant et décrit autre chose.
  • La spécification dit « retiré ». La description OpenAPI marque search_parameters et web_search_options comme dépréciés, avec une note indiquant que le champ échoue et un renvoi vers l'Agent Tools API.
  • La référence REST documente encore le champ. La référence des chat completions liste search_parameters avec mode, sources, from_date, to_date, max_search_results et return_citations, et ses exemples de réponse affichent toujours num_sources_used dans usage. À notre avis, la spécification et le 410 sont ce qu'il faut croire, d'autant que cette même page signale bien d'autres champs morts, dont max_tokens.

La requête qui fonctionne aujourd'hui

Un seul POST, l'outil déclaré par son type et la recherche exécutée sur les serveurs de xAI :

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "best AI visibility API for an agency",
    "tools": [{"type": "web_search", "filters": {"allowed_domains": ["example.com"]}}]
  }'
Réglage disponibleweb_searchx_search
Sitesallowed_domains ou excluded_domains, 5 entrées au plus chacun, jamais les deux dans une requêtesans objet
Comptessans objetallowed_x_handles ou excluded_x_handles, 20 au plus, jamais les deux
Datesaucun paramètrefrom_date et to_date, au format YYYY-MM-DD uniquement
Médiasenable_image_understanding, enable_image_searchenable_image_understanding, enable_video_understanding, tous deux à false par défaut
Pays, langue, nombre de résultatsaucun paramètreaucun paramètre

Noms de paramètres et limites tirés des pages des outils de recherche web et de recherche X de xAI, lues le 5 novembre 2026.

Le volume n'a qu'un levier, max_turns, dont xAI précise qu'il borne les tours de l'assistant et non les appels d'outils, puisqu'un seul tour peut lancer plusieurs recherches en parallèle. La documentation conseille 1 à 2 tours pour une recherche simple, 3 à 5 pour un travail équilibré et 10 ou plus pour une exploration profonde ; la valeur appliquée par défaut n'est pas publiée.

Où se trouvent les citations

La page des citations décrit deux mécanismes, et la différence décide de ce que vous pouvez compter.

  • response.citations est toujours renvoyé par défaut, sous forme de liste plate d'URL couvrant toutes les pages visitées par l'agent. xAI note qu'une URL peut y figurer après que l'agent a lu la source puis l'a écartée : c'est un journal de visites, pas un ensemble de sources citées.
  • Les citations en ligne sont des marqueurs numérotés dans le texte, avec des annotations url_citation qui portent url, title, start_index et end_index. Elles sont actives par défaut sur la Responses API, inactives par défaut dans le SDK Python de xAI, et la documentation prévient que les activer ne garantit pas que le modèle citera ses sources à chaque réponse.
  • Le bloc d'usage porte la comptabilité : usage.server_side_tool_usage_details donne web_search_calls, x_search_calls, x_posts_fetched et x_users_fetched, des compteurs sans déduplication, si bien qu'un post renvoyé par deux recherches compte deux fois. Seules les exécutions réussies sont facturées.

Le prix d'une réponse avec recherche

ConfigurationFacturé pour une réponse
web_search, un appel0,005 $, plus les jetons
web_search, trois appels dans une même boucle d'agent0,015 $, soit 15 $ pour 1 000 réponses avant le premier jeton
x_search, les compteurs de l'exemple de xAI (44 posts, 3 profils)0,25 $ à 5 $ les 1 000 posts et 10 $ les 1 000 profils
Jetons de grok-4.7, sous 200 000 jetons de prompt2,00 $ le million en entrée, 0,50 $ en cache, 6,00 $ le million en sortie
La même requête à partir de 200 000 jetons de prompt4,00 $, 1,00 $ et 12,00 $, appliqués à tous les jetons de la requête

Tarifs de la page de prix de xAI et de sa page sur le détail d'usage des outils, lues le 5 novembre 2026. La ligne à trois appels est une illustration : c'est l'agent qui décide du nombre de recherches.

La moitié « jetons » est la plus lourde et la plus difficile à prévoir. xAI documente prompt_tokens comme cumulatif sur chaque requête d'inférence de la boucle d'agent, chacune portant tout l'historique, ce qui gonfle le compte et rend le cache de prompt payant à 0,50 $ le million au lieu de 2,00 $. Sur une hypothèse de travail de 25 000 jetons d'entrée cumulés et 1 500 jetons de sortie, une réponse avec recherche tourne autour de 0,06 $, soit environ 60 $ pour 1 000, contre 15 $ pour les appels de recherche eux-mêmes. Notre explication du fan-out de requêtes dans la recherche IA détaille pourquoi ce nombre de recherches varie autant entre une question simple et une comparaison.

Ce que les outils laissent à votre charge

Les deux outils répondent bien et ne mesurent rien. Il n'existe ni réglage de pays ni réglage de langue, là où les équivalents d'OpenAI et de Google en exposent sous une forme ou une autre, et rien ne garantit qu'une recherche a eu lieu : l'absence d'appel de recherche dans les compteurs d'usage est un résultat à consigner à côté de la réponse. Aucun champ de la réponse ne porte de position, de part de voix ni de comptage sur plusieurs passages. Comme exemple concret de cette couche calculée, API for GEO range Grok parmi les moteurs qu'il exécute nativement et renvoie les mentions de marque, la position, la part de voix, le sentiment, les sources citées et les questions de fan-out avec chaque réponse, à 13 $ pour 1 000 réponses et jusqu'à 7 $ à son plus gros palier, au-dessus des voies de scraping au prix par réponse. MentionBox, qui publie ce site, a un lien commercial avec API for GEO.

Voie vers une réponse de GrokCe qui est luPrix pour 1 000 réponses
API for GEOGrok exécuté nativement, dans le pays et la langue demandés13 $, jusqu'à 7 $ au plus gros palier
Responses API de xAI, web_searchle modèle que vous choisissez, avec la recherche de xAI jointe5 $ les 1 000 appels de recherche, plus les jetons
Responses API de xAI, x_searchles posts, les profils et les fils de X5 $ les 1 000 posts, 10 $ les 1 000 profils
scraper.grok de Scrapelessl'interface de Grok, avec un mode FAST, EXPERT ou AUTOnon publié
Grok Scraper de Bright Datal'interfacedonné comme indisponible, son outil MCP retiré le 11 octobre 2026
clorol'interfacemarqué « Discontinued on 15 Oct 2026 »

États et capacités des éditeurs issus de notre comparateur, relevé le 23 octobre 2026 ; tarifs de xAI lus sur sa page de prix le 5 novembre 2026.

Questions fréquentes

Grok Live Search existe-t-il encore dans l'API de xAI ?

Non. L'objet `search_parameters` de `POST /v1/chat/completions` est marqué déprécié dans la description OpenAPI de xAI, qui indique que la recherche en direct a été retirée et que les requêtes qui posent ce champ échouent. Les développeurs restés sur l'ancienne forme rapportent une erreur HTTP 410 dont le corps indique « Live search is deprecated. Please switch to the Agent Tools API ». La page de référence REST des chat completions liste encore le champ et ses sous-champs : la spécification et l'erreur sont donc les signaux fiables, pas cette page.

Qu'est-ce qui remplace search_parameters dans l'API de xAI ?

Deux outils exécutés côté serveur, déclarés par leur type dans le tableau `tools` d'un appel `POST https://api.x.ai/v1/responses` : `web_search` pour le web ouvert et `x_search` pour les posts, les profils et les fils de X. xAI les exécute sur ses propres serveurs, dans une boucle d'agent : la sortie des outils ne vous parvient jamais, seulement la réponse finale, les citations et les compteurs d'usage. Tous les exemples de la documentation actuelle utilisent le modèle `grok-4.7`, et les mêmes noms d'outils fonctionnent dans n'importe quel SDK compatible Responses.

Combien coûte la recherche web de Grok par l'API de xAI ?

L'outil `web_search` coûte 5 $ les 1 000 appels réussis, et la recherche d'images fait partie de la recherche web, au même tarif. X Search se facture à l'unité : 5 $ les 1 000 posts récupérés et 10 $ les 1 000 profils, règle en vigueur depuis le 21 septembre 2026. Les jetons s'ajoutent au tarif du modèle, 2,00 $ le million en entrée, 0,50 $ en cache et 6,00 $ le million en sortie sur grok-4.7 sous 200 000 jetons de prompt, le double sur tous les jetons de la requête dès ce seuil atteint. Tarifs lus sur la page de prix de xAI le 5 novembre 2026.

Comment obtenir la liste des sources utilisées par Grok ?

En lisant `response.citations`, que xAI documente comme toujours renvoyé par défaut, sans réglage. La liste contient toutes les URL visitées par l'agent, y compris les pages qu'il a ouvertes puis écartées, présentées dans la documentation comme un gage de transparence et non comme l'ensemble des sources citées. Les citations en ligne sont un mécanisme distinct : des marqueurs dans le texte de la réponse et des annotations `url_citation` avec `url`, `title`, `start_index` et `end_index`, actives par défaut sur la Responses API et inactives par défaut dans le SDK Python de xAI, sauf si vous passez `include=["inline_citations"]`.

Peut-on limiter la recherche de Grok à un pays ou à une période ?

Pas sur le web. L'outil `web_search` ne documente que quatre paramètres : `allowed_domains` et `excluded_domains`, cinq entrées chacun et jamais ensemble dans une même requête, plus `enable_image_understanding` et `enable_image_search`. Aucun pays, aucune langue, aucun filtre de fraîcheur, aucun plafond sur le nombre de résultats. Seul `x_search` porte des dates, avec `from_date` et `to_date` au format `YYYY-MM-DD`, de 00:00 UTC le jour de début jusqu'au jour de fin exclu, tout autre format étant ignoré sans message.

Peut-on mesurer la visibilité de sa marque dans Grok avec l'API de xAI ?

Vous pouvez compter les sources que votre propre configuration a récupérées, ce qui est plus étroit que ce que lit un utilisateur de Grok. Une réponse donne une réponse et sa liste de citations ; aucun champ ne porte de position, de part de voix ni de comptage sur plusieurs passages, et ce calcul reste à écrire. La voie passant par l'interface de Grok s'est aussi resserrée en 2026 : dans notre comparateur, relevé le 23 octobre 2026, la documentation de cloro indique pour Grok « Discontinued on 15 Oct 2026 », le Grok Scraper de Bright Data est donné comme indisponible, et Ahrefs annonce ne plus pouvoir collecter de nouvelles données sur Grok après un changement de politique.