list_retailers liste les revendeurs vers lesquels les IA envoient l'acheteur sur un projet e-commerce : marketplaces, revendeurs, grands magasins. Pour chacun, il indique à quelle fréquence la marque est aussi citée quand ce revendeur apparaît, par rapport à sa moyenne.

C'est la page Revendeurs du dashboard, en JSON. Un revendeur est un nom que l'IA a classé comme un magasin, pas comme une marque rivale (verdict RETAILER), et que personne n'a rejeté. Les revendeurs ne comptent jamais comme concurrents.

Quand l'utiliser

Appelez-le sur un projet en mode e-commerce (voir update_project_settings) pour répondre à « où ChatGPT dit-il d'acheter, et est-ce que j'y suis ? ». Un revendeur souvent cité avec un brandRate faible est un magasin où l'IA envoie l'acheteur vers d'autres marques : l'endroit où être référencé, ou où améliorer votre fiche produit. Sur un projet sans mode e-commerce, la liste est vide.

Input

Champ	Type	Défaut	Description
`projectId`	string (CUID)	requis	Projet à interroger.
`filters.dateRange`	`{ from?, to? }` (date ou datetime ISO)	tout l'historique	Réponses de cette période seulement.
`filters.llms`	tableau de clés LLM	moteurs du projet	Réponses de ces moteurs seulement.
`filters.nameContains`	string	-	Recherche insensible à la casse sur le nom ou un alias.
`sortBy`	`responses_desc`, `brand_rate_asc`, `brand_rate_desc`, `name_asc`	`responses_desc`	Ordre de toute la liste, avant la pagination. Les revendeurs sans taux passent en dernier.
`cursor`	string	-	`pageInfo.nextCursor` de la page précédente.
`limit`	nombre (1 à 100)	20	Taille de page.

Réponse

{
  "data": [
    {
      "id": "clr1...",
      "name": "Amazon",
      "aliases": ["amazon.fr"],
      "responses": 42,
      "llms": ["chatgpt", "perplexity", "google_ai_mode"],
      "brandRate": 31,
      "brandWithRetailer": 13,
      "gap": -9
    },
    {
      "id": "clr2...",
      "name": "Decathlon",
      "aliases": [],
      "responses": 17,
      "llms": ["chatgpt", "gemini"],
      "brandRate": 65,
      "brandWithRetailer": 11,
      "gap": 25
    }
  ],
  "pageInfo": { "hasMore": false, "nextCursor": null, "totalCount": 2 },
  "summary": {
    "results": 210,
    "brandRate": 40,
    "retailerRate": 38,
    "brandRateWithRetailer": 33,
    "officialSiteRate": 12
  }
}

Champs d'une ligne :

responses : réponses qui citent le revendeur sur la période.
brandRate : part de ces réponses qui citent aussi la marque, en pourcentage. brandWithRetailer en est le nombre brut.
gap : brandRate moins le taux de citation global de la marque, en points. Négatif : la marque est plus faible quand ce revendeur apparaît.

Champs du résumé, tous en pourcentage des réponses de la période sauf results : brandRate (réponses qui citent la marque), retailerRate (réponses qui citent au moins un revendeur), brandRateWithRetailer (taux de la marque parmi celles-ci), officialSiteRate (réponses qui citent le site de la marque).

Astuces et patterns

Triez par brand_rate_asc pour voir d'abord les magasins où les moteurs recommandent d'autres marques.
Comparez officialSiteRate à retailerRate : quand les revendeurs sont bien plus cités que votre site, les moteurs envoient l'acheteur en magasin, et vos fiches chez eux comptent autant que votre site.
Ouvrez une ligne avec get_retailer pour voir les pages citées : votre fiche produit, celle d'un concurrent, ou une page de catégorie.
Un magasin classé comme concurrent par erreur, ou l'inverse : corrigez-le avec bulk_update_competitor_status (kind: RETAILER ou COMPETITOR, ou status: REJECTED pour l'écarter).

Tools liés

get_retailer : le détail d'un revendeur
list_competitors : les marques rivales, et tous les verdicts avec filters.verdict
bulk_update_competitor_status : reclasser ou rejeter un revendeur
update_project_settings : activer le mode e-commerce

Quand l'utiliser

Input

Réponse

Astuces et patterns

Tools liés

Vous pouvez voir où vous en êtes dès aujourd'hui.