get_retailer

get_retailer renvoie le détail d'un revendeur d'un projet e-commerce : à quelle fréquence la marque est citée quand les moteurs envoient l'acheteur chez lui, sur quels prompts et quels moteurs, quelles marques ils recommandent avec lui, et lesquelles de ses pages ils citent.

C'est la fiche revendeur du dashboard, en JSON. Les pages vous disent si les moteurs tombent sur votre fiche produit chez ce revendeur, sur celle d'un concurrent, ou sur une page générique.

Quand l'utiliser

Appelez-le après list_retailers, avec l'id d'un revendeur, pour répondre à « pourquoi je n'apparais pas quand ChatGPT recommande ce magasin ? ». Les marques co-citées montrent qui prend votre place ; les pages citées montrent si votre fiche existe aux yeux de l'IA. Passez un promptId pour tout restreindre à une question.

Input

Réponse

{
  "success": true,
  "retailer": { "id": "clr1...", "name": "Amazon", "aliases": ["amazon.fr"] },
  "responses": 42,
  "brandPresence": { "cited": 42, "withBrand": 13, "rate": 31 },
  "avgPosition": 2.4,
  "byLlm": [
    { "llm": "chatgpt", "count": 25 },
    { "llm": "perplexity", "count": 17 }
  ],
  "prompts": [
    { "id": "clp1...", "text": "meilleures chaussures de trail pour débuter", "count": 9, "llms": ["chatgpt", "perplexity"] }
  ],
  "coCitedBrands": [
    { "id": "clc1...", "name": "Salomon", "count": 20, "rate": 48 }
  ],
  "pages": [
    {
      "url": "https://www.amazon.fr/dp/B0EXAMPLE",
      "title": "Salomon Speedcross 6",
      "count": 6,
      "withBrand": 1,
      "owner": { "kind": "competitor", "name": "Salomon" }
    }
  ],
  "productsSold": [{ "id": "prod_9k2", "name": "Speedcross 6", "count": 4 }],
  "sources": [{ "domain": "amazon.fr", "count": 14 }]
}

Champs :

• responses : mentions du revendeur sur la période. brandPresence compte les réponses distinctes qui le citent (cited), celles qui citent aussi la marque (withBrand), et le taux en pourcentage.
• prompts : les 20 prompts où le revendeur est le plus cité, avec les moteurs.
• coCitedBrands : concurrents confirmés cités dans les mêmes réponses, avec leur part des réponses du revendeur (rate).
• pages : pages du revendeur citées par les moteurs (50 au plus). owner.kind vaut brand (votre fiche produit), competitor (avec son name) ou other.
• productsSold : produits dont la carte shopping de l'IA renvoie vers ce revendeur (marchand affiché sur une carte ChatGPT, ou domaine de la fiche sur Copilot), 10 au plus, avec le nombre de réponses (count).
• sources : les 10 domaines les plus souvent attribués au revendeur.

Erreur : retailer_not_found (id inconnu, autre projet, ou entité qui n'est pas classée comme revendeur).

Astuces et patterns

• Les pages owner.kind: competitor avec un count élevé sont les fiches à égaler : même magasin, même question, votre produit absent.
• Aucune page owner.kind: brand : les moteurs ne citent jamais votre fiche produit chez ce revendeur. Vérifiez qu'elle existe et qu'elle nomme le produit comme le cherchent les acheteurs.
• Croisez coCitedBrands avec list_competitor_sources sur la première marque pour voir où elle gagne ailleurs.
• Mauvais classement ? bulk_update_competitor_status fait passer une entité de revendeur à produit ou concurrent, ou la rejette.

Tools liés

• list_retailers : tous les revendeurs du projet, avec la présence de la marque
• list_competitors : les marques rivales du projet
• list_competitor_sources : les domaines où un concurrent est cité
• bulk_update_competitor_status : reclasser ou rejeter un revendeur