list_products

list_products renvoie les produits suivis sur un projet e-commerce : ceux de votre marque et ceux de vos concurrents. Chaque ligne dit combien de réponses IA citent le produit, sur quels moteurs, et quand il est apparu pour la première et la dernière fois.

Un produit est une gamme (« Trav-Ler », « Soft-Picks Comfort Flex »), pas une variante : tailles, couleurs, tailles ISO et lots y sont repliés. Les mentions sont comptées à travers les noms bruts employés par les moteurs (les alias du produit) : une fusion ou une séparation recalcule donc tout l'historique.

Quand l'utiliser

Appelez-le pour répondre à « quels produits de ma marque les IA recommandent-elles, et lesquels de mes concurrents poussent-elles à la place ? ». Filtrez sur brand: "ours" pour voir votre catalogue, y compris les produits jamais cités (responses: 0), ou sur un competitorId pour lister les gammes d'un concurrent. Les lignes avec un mergeIntoId sont des doublons probables à ranger.

La liste est vide sur un projet qui n'est pas en mode e-commerce (voir update_project_settings).

Input

Réponse

{
  "data": [
    {
      "id": "clpr1...",
      "name": "Trav-Ler",
      "competitorId": null,
      "brand": "GUM",
      "category": "Brossettes interdentaires",
      "status": "CONFIRMED",
      "source": "CATALOG",
      "responses": 38,
      "mentionRate": 9,
      "llms": ["CHATGPT", "COPILOT", "PERPLEXITY"],
      "firstSeenAt": "2026-09-23T20:01:12.000Z",
      "lastSeenAt": "2026-10-07T20:00:41.000Z",
      "sitePageUrl": "https://www.sunstargum.com/fr/produits/trav-ler",
      "mergeIntoId": null,
      "mergeIntoName": null
    },
    {
      "id": "clpr2...",
      "name": "Easypick",
      "competitorId": "clc1...",
      "brand": "TePe",
      "category": "Bâtonnets interdentaires",
      "status": "SUGGESTED",
      "source": "CARD",
      "responses": 21,
      "mentionRate": 5,
      "llms": ["CHATGPT", "COPILOT"],
      "firstSeenAt": "2026-09-24T20:00:08.000Z",
      "lastSeenAt": "2026-10-06T20:00:31.000Z",
      "sitePageUrl": null,
      "mergeIntoId": null,
      "mergeIntoName": null
    }
  ],
  "pageInfo": { "hasMore": true, "nextCursor": "20", "totalCount": 64 },
  "summary": { "products": 64, "ours": 22, "cited": 41 }
}

Champs :

• competitorId : la marque qui fabrique le produit. null désigne votre propre marque ; brand donne le nom dans les deux cas.
• status : CONFIRMED, SUGGESTED (vu seulement dans le texte des réponses, en attente de revue) ou REJECTED. Un produit rejeté n'est jamais recréé.
• source : l'origine du produit. CATALOG (pages produit de votre site ou alias que vous avez saisis), CARD (carte produit structurée de Copilot ou de ChatGPT shopping), TEXT (texte des réponses seulement) ou MANUAL (créé par une séparation).
• category : la catégorie de produit (« Brossettes interdentaires »), unité de get_product_share_of_voice. L'IA range chaque nouveau produit après un scan et réutilise les catégories existantes du projet : les produits de marques différentes partagent donc une même catégorie. null tant qu'il n'est pas rangé. Une catégorie posée avec update_product n'est jamais écrasée.
• responses : réponses distinctes qui citent le produit sur la période. firstSeenAt et lastSeenAt valent null s'il n'a jamais été cité.
• mentionRate : responses en % entier de toutes les réponses de la période, ou null si la période n'a aucune réponse.
• sitePageUrl : la page produit de votre site, pour les produits du catalogue.
• mergeIntoId et mergeIntoName : le produit dont celui-ci est probablement un doublon, selon l'IA, et son nom. Fusionnez-le avec merge_products ou écartez la suggestion avec update_product.
• summary : produits après filtres, combien sont à vous, et combien ont été cités au moins une fois.

Astuces et patterns

• neverCited: true : votre catalogue que les IA ne recommandent jamais sur la période.
• Filtrez sur une category pour comparer vos produits à ceux de vos concurrents dans une même catégorie.
• Comparez les gammes les plus citées d'un concurrent avec les vôtres sur le même dateRange pour voir quel produit prend votre place.
• Passez en revue les produits SUGGESTED avec bulk_update_product_status : confirmez les vrais, rejetez le bruit.
• Appelez get_product sur une ligne pour ses prompts, moteurs, revendeurs et prix.

Tools liés

• get_product : le détail d'un produit
• get_product_share_of_voice : votre part de voix par catégorie de produit
• list_product_prompt_matrix : quel prompt fait remonter quel produit
• merge_products : fusionner des doublons
• bulk_update_product_status : confirmer ou rejeter des produits
• list_retailers : où les IA envoient l'acheteur
• list_competitors : les marques rivales du projet