get_product

get_product renvoie le détail d'un produit d'un projet e-commerce : les noms bruts employés par les IA pour le désigner, les moteurs et prompts où il est cité, et ce que montraient les cartes produits (revendeurs, prix, note).

Les cartes produits sont les blocs shopping structurés que certains moteurs affichent à côté de leur réponse. Seuls Copilot et ChatGPT shopping en renvoient : retailers, prices et rating viennent donc de ces deux moteurs.

Quand l'utiliser

Appelez-le après list_products, avec l'id d'un produit, pour répondre à « sur quelles questions ce produit est-il recommandé, et où les moteurs envoient-ils l'acheteur pour l'acheter ? ». La liste aliases montre toutes les façons dont les moteurs ont nommé le produit ; leurs ids servent à split_product quand deux produits différents se sont retrouvés sous un même nom.

Input

Réponse

{
  "success": true,
  "product": {
    "id": "clpr1...",
    "name": "Soft-Picks Comfort Flex",
    "competitorId": null,
    "brand": "GUM",
    "status": "CONFIRMED",
    "source": "CATALOG",
    "category": "Bâtonnets interdentaires",
    "sitePageUrl": "https://www.sunstargum.com/fr/produits/soft-picks-comfort-flex",
    "mergeIntoId": null
  },
  "responses": 27,
  "mentionRate": 7,
  "aliases": [
    { "id": "cla1...", "rawName": "GUM Soft-Picks Comfort Flex", "mentions": 27 },
    { "id": "cla2...", "rawName": "GUM SOFT-PICKS COMFORT FLEX MINT", "mentions": 4 }
  ],
  "byLlm": [
    { "llm": "CHATGPT", "responses": 18 },
    { "llm": "COPILOT", "responses": 9 }
  ],
  "prompts": [
    { "id": "clp1...", "text": "Quel cure-dent souple choisir pour nettoyer entre les dents ?", "responses": 11, "llms": ["CHATGPT", "COPILOT"] }
  ],
  "retailers": [
    { "name": "Pharmacie des Drakkars", "cards": 6 },
    { "name": "redcare-pharmacie.fr", "cards": 3 }
  ],
  "prices": [
    { "price": "4,06 €", "cards": 5 },
    { "price": "4.49 €", "cards": 2 }
  ],
  "rating": { "average": 4.6, "maxReviews": 738 },
  "sources": [
    { "sourceId": "cls1...", "domain": "tepe.com", "url": "https://tepe.com/fr/produits/interdental-brushes/brossettes-interdentaires-tepe-angles", "responses": 2 },
    { "sourceId": "cls2...", "domain": "cocooncenter.com", "url": "https://cocooncenter.com/c/hygiene-bucco-dentaire-brossettes.html", "responses": 1 }
  ],
  "excerpts": [
    {
      "resultId": "clr1...",
      "promptText": "C'est quoi les meilleures brossettes interdentaires disponibles en France ?",
      "llm": "CHATGPT",
      "date": "2026-10-09T09:15:43.000Z",
      "position": 2,
      "excerpt": "### 2. TePe Original",
      "alongside": [
        { "productId": "clpr2...", "name": "CPS Prime", "brand": "Curaprox" },
        { "productId": "clpr3...", "name": "Trav-Ler", "brand": null }
      ]
    }
  ],
  "progression": [
    { "date": "2026-10-08T00:00:00.000Z", "responses": 3 },
    { "date": "2026-10-09T00:00:00.000Z", "responses": 5 }
  ]
}

sources, excerpts et progression ne reviennent que si include les demande.

Champs :

• product : les mêmes champs qu'une ligne de list_products, sans les compteurs. competitorId: null désigne votre propre marque. category est la catégorie de produit, null tant que l'IA ne l'a pas rangé.
• responses : réponses distinctes qui citent le produit sur la période. mentionRate : leur % entier de toutes les réponses de la période, ou null si la période n'a aucune réponse.
• aliases : noms bruts employés par les moteurs pour le produit, sur tout l'historique, les plus mentionnés d'abord (100 au plus). mentions compte toutes les mentions sous ce nom.
• byLlm : réponses distinctes qui citent le produit, par moteur.
• prompts : les 20 prompts où le produit est le plus cité, avec les moteurs.
• retailers : depuis les cartes produits seulement. Le domaine du magasin quand la carte pointe vers lui (Copilot), sinon le nom du marchand (ChatGPT shopping). 20 au plus.
• prices : prix tels qu'affichés sur les cartes, les plus fréquents d'abord. Formats et devises varient selon le moteur.
• rating : note moyenne et plus grand nombre d'avis vus sur les cartes, ou null si aucune carte n'avait de note.
• sources : les pages sur lesquelles l'IA s'appuie quand elle nomme le produit, les plus utilisées d'abord (30 au plus). Même règle que pour les concurrents : la source appuie un passage de la réponse qui nomme le produit. Quand le passage énumère plusieurs produits, chacun reçoit la source. responses compte les réponses où c'est le cas.
• excerpts : les 10 dernières réponses qui nomment le produit. excerpt est la ligne de la réponse qui le nomme, null quand le nom n'apparaît que dans une carte produit. position est son rang dans la réponse quand le moteur les classe. alongside liste les autres produits de la même réponse (brand: null = les vôtres).
• progression : réponses distinctes qui citent le produit, jour par jour.

Erreur : product_not_found (id inconnu, autre projet, ou projet qui n'est pas en mode e-commerce).

Astuces et patterns

• Un produit concurrent avec beaucoup de retailers et une rating élevée est celui que les moteurs recommandent en confiance. Vérifiez si votre gamme équivalente a des cartes tout court.
• Pour comprendre pourquoi un produit concurrent est cité, demandez include.sources sur lui et sur le vôtre : les pages qu'il a et que vous n'avez pas sont celles où faire référencer ou tester votre produit.
• include.excerpts montre comment l'IA parle du produit et face à quels concurrents, sans rapatrier les réponses entières.
• Deux produits clairement différents parmi les aliases (une recharge et un kit de démarrage, par exemple) ? Sortez-en un avec split_product.
• Pour situer le produit face à ses rivaux de la même catégorie, appelez get_product_share_of_voice avec sa category.
• Croisez prompts avec get_recommendation sur le même prompt pour voir ce qui ferait citer votre produit.

Tools liés

• list_products : tous les produits du projet
• split_product : sortir des noms bruts vers un nouveau produit
• update_product : renommer un produit, changer sa marque ou sa catégorie
• get_product_share_of_voice : votre part de voix par catégorie de produit
• get_retailer : le détail d'un revendeur