get_product

get_product returns the detail of one product of an e-commerce project: the raw names AI engines used for it, the engines and prompts where it is cited, and what the product cards showed (retailers, prices, rating).

Product cards are the structured shopping blocks some engines display next to their answer. Only Copilot and ChatGPT shopping return them, so retailers, prices and rating come from those two engines.

When to use

Call it after list_products, with a product id, to answer "on which questions is this product recommended, and where do engines send buyers to get it?". The aliases list shows every way engines named the product; their ids feed split_product when two different products ended up under one name.

Input

Response

{
  "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 and progression only come back when asked for in include.

Fields:

• product: same fields as a list_products row, without the counts. competitorId: null means your own brand. category is the product category, null until the AI sorts it.
• responses: distinct answers citing the product in the window. mentionRate: their whole % of all the window's answers, or null when the window has no answer.
• aliases: raw names engines used for the product, all time, most mentioned first (100 at most). mentions counts every mention under that name.
• byLlm: distinct answers citing the product, per engine.
• prompts: the 20 prompts where the product is cited most, with the engines.
• retailers: from product cards only. The store domain when the card links to it (Copilot), the merchant name otherwise (ChatGPT shopping). 20 at most.
• prices: prices as displayed on the cards, most frequent first. Formats and currencies vary by engine.
• rating: average rating and highest review count seen on the cards, or null when no card had a rating.
• sources: the pages the AI relies on when it names the product, most used first (30 at most). Same rule as for competitors: the source backs a passage of the answer that names the product. When the passage lists several products, each one gets the source. responses counts the answers where it does.
• excerpts: the 10 latest answers naming the product. excerpt is the line of the answer that names it, null when the name only appears in a product card. position is its rank in the answer when the engine orders it. alongside lists the other products of the same answer (brand: null = yours).
• progression: distinct answers citing the product, per day.

Error: product_not_found (unknown id, another project, or a project not in e-commerce mode).

Tips and patterns

• A competitor product with many retailers and a high rating is the one engines can recommend with confidence. Check whether your equivalent range has cards at all.
• To learn why a competitor product gets cited, ask for include.sources on it and on yours: the pages it has and you lack are where to get your product listed or reviewed.
• include.excerpts shows how the AI talks about the product and against which rivals, without pulling full answers.
• Two clearly different products among aliases (a refill pack and a starter kit, for example)? Move one with split_product.
• To place the product against its rivals of the same category, call get_product_share_of_voice with its category.
• Combine prompts with get_recommendation on the same prompt to see what would get your product cited there.

Related tools

• list_products: every product of the project
• split_product: move raw names to a new product
• update_product: rename a product, change its brand or its category
• get_product_share_of_voice: your share of voice by product category
• get_retailer: detail of one retailer