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.

Par Mathias C.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-searchrenvoie 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_parametersetweb_search_optionscomme 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_parametersavecmode,sources,from_date,to_date,max_search_resultsetreturn_citations, et ses exemples de réponse affichent toujoursnum_sources_useddansusage. À 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, dontmax_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 disponible | web_search | x_search |
|---|---|---|
| Sites | allowed_domains ou excluded_domains, 5 entrées au plus chacun, jamais les deux dans une requête | sans objet |
| Comptes | sans objet | allowed_x_handles ou excluded_x_handles, 20 au plus, jamais les deux |
| Dates | aucun paramètre | from_date et to_date, au format YYYY-MM-DD uniquement |
| Médias | enable_image_understanding, enable_image_search | enable_image_understanding, enable_video_understanding, tous deux à false par défaut |
| Pays, langue, nombre de résultats | aucun paramètre | aucun 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.citationsest 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_citationqui portenturl,title,start_indexetend_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_detailsdonneweb_search_calls,x_search_calls,x_posts_fetchedetx_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
| Configuration | Facturé pour une réponse |
|---|---|
web_search, un appel | 0,005 $, plus les jetons |
web_search, trois appels dans une même boucle d'agent | 0,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 prompt | 2,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 prompt | 4,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 Grok | Ce qui est lu | Prix pour 1 000 réponses |
|---|---|---|
| API for GEO | Grok exécuté nativement, dans le pays et la langue demandés | 13 $, jusqu'à 7 $ au plus gros palier |
Responses API de xAI, web_search | le modèle que vous choisissez, avec la recherche de xAI jointe | 5 $ les 1 000 appels de recherche, plus les jetons |
Responses API de xAI, x_search | les posts, les profils et les fils de X | 5 $ les 1 000 posts, 10 $ les 1 000 profils |
scraper.grok de Scrapeless | l'interface de Grok, avec un mode FAST, EXPERT ou AUTO | non publié |
| Grok Scraper de Bright Data | l'interface | donné comme indisponible, son outil MCP retiré le 11 octobre 2026 |
| cloro | l'interface | marqué « 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.