Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.
Filtres de l’endpoint des indicateurs shopping. Seuls les filtres appliqués par la page Shopping Insights sont acceptés ; toute autre clé de filtre est rejetée avec 400.
Blocs du tableau de bord Shopping Insights. Taux de 0 à 100 % ; positions à partir de 1, un nombre faible étant meilleur.
Show child attributes
Cette page vous a-t-elle été utile ?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AthenaHQ","colors":{"primary":"#4f39f6","light":"#7c86ff","dark":"#4f39f6"},"logo":{"light":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68","dark":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68"},"favicon":"https://mintcdn.com/athenahq/l-RALGQGlLg9vCM3/favicon.ico?fit=max\u0026auto=format\u0026n=l-RALGQGlLg9vCM3\u0026q=85\u0026s=902f75ca9d61dedcf06910b630c2349b","navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.athenahq.ai/settings/api"}},"footer":{"socials":{"website":"https://athenahq.ai","linkedin":"https://linkedin.com/company/athena-hq"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"getting-started/setup"},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"href":"es/getting-started/setup"},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"href":"fr/getting-started/setup"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"athenahq","hasAudioNarration":false,"actualSubdomain":"athenahq","customDomains":["docs.athenahq.ai"],"gitSource":{"type":"github","owner":"ay-ay-ay-ay","repo":"athenahq","deployBranch":"main","contentDirectory":"docs-api","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae952f0f8a6220500f817a6","collectionId":"3f17186c-cde6-4889-93f4-f968047e7890","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae952f0f8a6220500f817a6"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae952f0f8a6220500f817a6","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"en","tag":"API Reference","count":128},{"language":"es","tag":"Referencia de la API","count":128},{"language":"fr","tag":"Référence de l’API","count":128},{"language":"en","tag":"Documentation","count":63},{"language":"es","tag":"Documentación","count":63},{"language":"fr","tag":"Documentation","count":63},{"language":"en","tag":"Page Reference","count":55},{"language":"es","tag":"Referencia de páginas","count":55},{"language":"fr","tag":"Référence des pages","count":55},{"language":"en","tag":"Content \u0026 Knowledge","count":38},{"language":"es","tag":"Contenido y conocimiento","count":38},{"language":"fr","tag":"Contenu et connaissances","count":38},{"language":"en","tag":"Core Resources","count":33},{"language":"es","tag":"Recursos principales","count":33},{"language":"fr","tag":"Ressources principales","count":33},{"language":"en","tag":"Administration","count":32},{"language":"es","tag":"Administración","count":32},{"language":"fr","tag":"Administration","count":32},{"language":"en","tag":"Content Hub","count":19},{"language":"es","tag":"Centro de contenido","count":19},{"language":"fr","tag":"Content Hub","count":19},{"language":"en","tag":"Analytics","count":16},{"language":"es","tag":"Analítica","count":16},{"language":"fr","tag":"Analyses","count":16},{"language":"en","tag":"Knowledge Base","count":15},{"language":"es","tag":"Base de conocimientos","count":15},{"language":"fr","tag":"Base de connaissances","count":15},{"language":"en","tag":"Members","count":12},{"language":"es","tag":"Miembros","count":12},{"language":"fr","tag":"Membres","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"fr/api-reference/metrics/shopping-metrics","slug":"/fr/api-reference/metrics/shopping-metrics","pageMetadata":{"title":"Métriques d’achat","description":"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. `models` accepte `chatgpt`, `ai_mode`, `gemini`, `perplexity` et `copilot`. Nécessite une offre payante.","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/fr/api-reference/metrics/shopping-metrics"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. \", _jsx(_components.code, {\n children: \"models\"\n }), \" accepte \", _jsx(_components.code, {\n children: \"chatgpt\"\n }), \", \", _jsx(_components.code, {\n children: \"ai_mode\"\n }), \", \", _jsx(_components.code, {\n children: \"gemini\"\n }), \", \", _jsx(_components.code, {\n children: \"perplexity\"\n }), \" et \", _jsx(_components.code, {\n children: \"copilot\"\n }), \". Nécessite une offre payante.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Métriques d’achat","description":"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. `models` accepte `chatgpt`, `ai_mode`, `gemini`, `perplexity` et `copilot`. Nécessite une offre payante.","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/fr/api-reference/metrics/shopping-metrics"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Metrics"],"summary":"Métriques d’achat","description":"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. `models` accepte `chatgpt`, `ai_mode`, `gemini`, `perplexity` et `copilot`. Nécessite une offre payante.","operationId":"getShoppingMetrics","security":["6ee4283f-699a-4158-8ccd-c239bbdb0bb4"],"requestBody":"c4c6ff8d-f67d-4616-a388-922c87e33a3e","responses":{"200":"6abcfaf9-52e1-4e79-ada9-f000635ebc34","400":"fc1eae9c-ec4e-4940-b088-569805169993","401":"ab398c93-2798-4e93-a138-172b47bd5a11","403":"7da89a53-6089-4def-9649-27d7a7379fbe","404":"2f91ec0a-27ff-4078-996b-4a4b754575ee","500":"cb9da8df-3287-4ebf-9543-d3da2dd72e22"},"method":"post","type":"path","servers":["e7dec90e-429a-4746-8471-ec9f07e264b7"],"path":"/api/v1/metrics/shopping","baseUrlOptions":["https://api.athenahq.ai"],"title":"Métriques d’achat","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Corps de la requête pour l’endpoint des indicateurs shopping","required":["website_id","filters"],"properties":{"website_id":{"type":"string","format":"uuid","description":"ID du site dont interroger les métriques d’achat","example":"123e4567-e89b-12d3-a456-426614174000","isRequired":true,"uniqueKey":"website_id","typeLabel":"string\u003cuuid>"},"filters":{"type":"object","description":"Filtres de l’endpoint des indicateurs shopping. Seuls les filtres appliqués par la page Shopping Insights sont acceptés ; toute autre clé de filtre est rejetée avec 400.","required":["start_date"],"properties":{"start_date":{"type":"string","format":"date","description":"Début de période inclus, YYYY-MM-DD (UTC)","example":"2026-08-01","isRequired":true,"uniqueKey":"filters.start_date","typeLabel":"string\u003cdate>"},"end_date":{"type":"string","format":"date","description":"Fin de période incluse, YYYY-MM-DD (UTC). Aujourd’hui par défaut. Doit être au moins start_date.","example":"2026-08-31","uniqueKey":"filters.end_date","typeLabel":"string\u003cdate>"},"schedule_id":{"oneOf":[{"type":"string","description":"Sélectionnez une planification de collecte, avec la valeur renvoyée par GET /api/v1/prompt-schedules. Par défaut inclut l’historique antérieur à la transition et les exécutions ponctuelles ; les planifications archivées conservent leurs résultats. L’ancien jeton manual est accepté comme alias de default. Ce champ accepte une seule planification ; une liste renvoie 400.","default":"default","enum":["default","manual"],"uniqueKey":"filters.schedule_id.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"Sélectionnez une planification de collecte, avec la valeur renvoyée par GET /api/v1/prompt-schedules. Par défaut inclut l’historique antérieur à la transition et les exécutions ponctuelles ; les planifications archivées conservent leurs résultats. L’ancien jeton manual est accepté comme alias de default. Ce champ accepte une seule planification ; une liste renvoie 400.","format":"uuid","default":"default","uniqueKey":"filters.schedule_id.oneOf.1","typeLabel":"string\u003cuuid>"}],"uniqueKey":"filters.schedule_id","typeLabel":"enum\u003cstring> | string\u003cuuid>"},"models":{"type":"array","description":"Modèles compatibles avec l’achat à inclure. Omettez pour tous.","items":{"type":"string","enum":["chatgpt","ai_mode","gemini","perplexity","copilot"],"uniqueKey":"filters.models.items.[INDEX]","typeLabel":"enum\u003cstring>"},"example":["chatgpt"],"uniqueKey":"filters.models","typeLabel":"enum\u003cstring>[]"},"competitor_ids":{"type":"array","description":"UUID concurrents à conserver dans leurs blocs. Les produits propres sont toujours inclus. Omettez pour tous les concurrents.","items":{"type":"string","format":"uuid","uniqueKey":"filters.competitor_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"filters.competitor_ids","typeLabel":"string\u003cuuid>[]"},"prompt_tags":{"type":"array","description":"ID de tags de prompts selon lesquels filtrer (répertoriez les tags via GET /api/v1/prompt-tags). Omettez pour tous les tags.","items":{"type":"string","format":"uuid","uniqueKey":"filters.prompt_tags.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"filters.prompt_tags","typeLabel":"string\u003cuuid>[]"},"prompt_tags_operator":{"type":"string","enum":["is_any_of","has_all_of"],"description":"Combinaison de prompt_tags : is_any_of correspond à une des étiquettes ; has_all_of exige toutes les étiquettes. Par défaut : is_any_of.","uniqueKey":"filters.prompt_tags_operator","typeLabel":"enum\u003cstring>"},"target_identifiers":{"type":"array","description":"Identifiants cibles pour filtrer les réponses. La chaîne littérale no-identifier sélectionne les réponses sans identifiant cible. Omettez pour toutes.","items":{"type":"string","uniqueKey":"filters.target_identifiers.items.[INDEX]","typeLabel":"string"},"uniqueKey":"filters.target_identifiers","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"filters","typeLabel":"object"},"top_products_limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Nombre de produits à renvoyer dans chacun de top_own_products et top_competitor_products","uniqueKey":"top_products_limit","typeLabel":"integer"}},"example":{"website_id":"123e4567-e89b-12d3-a456-426614174000","filters":{"start_date":"2026-08-01","end_date":"2026-08-31","models":["chatgpt"]},"top_products_limit":10},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"website_id":"123e4567-e89b-12d3-a456-426614174000","filters":{"start_date":"2026-08-01","end_date":"2026-08-31","models":["chatgpt"]},"top_products_limit":10}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6abcfaf9-52e1-4e79-ada9-f000635ebc34":{"description":"Réponse réussie avec les métriques d’achat","content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"object","description":"Blocs du tableau de bord Shopping Insights. Taux de 0 à 100 % ; positions à partir de 1, un nombre faible étant meilleur.","required":["summary","offer_summary","top_own_products","top_competitor_products","competitor_breakdown","merchant_breakdown","position_distribution","price_comparison","trend"],"properties":{"summary":{"type":"object","description":"Totaux principaux sur toutes les réponses shopping de la période","required":["total_shopping_responses","responses_with_own_products","appearance_rate","total_products","own_products","competitor_products","avg_own_position","avg_competitor_position"],"properties":{"total_shopping_responses":{"type":"integer","description":"Réponses contenant un carrousel de produits","example":50,"isRequired":true,"uniqueKey":"data.summary.total_shopping_responses","typeLabel":"integer"},"responses_with_own_products":{"type":"integer","description":"Réponses d’achat incluant au moins un produit de la marque","example":20,"isRequired":true,"uniqueKey":"data.summary.responses_with_own_products","typeLabel":"integer"},"appearance_rate":{"type":"number","description":"responses_with_own_products / total_shopping_responses en pourcentage de 0 à 100","example":40,"isRequired":true,"uniqueKey":"data.summary.appearance_rate","typeLabel":"number"},"total_products":{"type":"integer","description":"Apparitions des produits dans l’ensemble des réponses shopping","example":150,"isRequired":true,"uniqueKey":"data.summary.total_products","typeLabel":"integer"},"own_products":{"type":"integer","description":"Apparitions des produits propres à la marque","example":40,"isRequired":true,"uniqueKey":"data.summary.own_products","typeLabel":"integer"},"competitor_products":{"type":"integer","description":"Apparitions attribuées aux concurrents suivis","example":110,"isRequired":true,"uniqueKey":"data.summary.competitor_products","typeLabel":"integer"},"avg_own_position":{"oneOf":[{"type":"number","description":"Position moyenne des produits de la marque dans les carrousels","example":2.5,"isRequired":true,"uniqueKey":"data.summary.avg_own_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne des produits de la marque dans les carrousels","example":2.5,"isRequired":true,"uniqueKey":"data.summary.avg_own_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.summary.avg_own_position","typeLabel":"number | null"},"avg_competitor_position":{"oneOf":[{"type":"number","description":"Position moyenne des produits concurrents dans le carrousel","example":4.2,"isRequired":true,"uniqueKey":"data.summary.avg_competitor_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne des produits concurrents dans le carrousel","example":4.2,"isRequired":true,"uniqueKey":"data.summary.avg_competitor_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.summary.avg_competitor_position","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.summary","typeLabel":"object"},"offer_summary":{"type":"object","description":"Offres de distributeurs (prix affichés) associées aux produits de la période","required":["total_offers","products_with_offers","competitor_offers","currency","avg_price"],"properties":{"total_offers":{"type":"integer","description":"Offres associées aux produits de la marque","example":200,"isRequired":true,"uniqueKey":"data.offer_summary.total_offers","typeLabel":"integer"},"products_with_offers":{"type":"integer","description":"Apparitions de produits de marque comportant au moins une offre","example":80,"isRequired":true,"uniqueKey":"data.offer_summary.products_with_offers","typeLabel":"integer"},"competitor_offers":{"type":"integer","description":"Offres des produits concurrents","example":60,"isRequired":true,"uniqueKey":"data.offer_summary.competitor_offers","typeLabel":"integer"},"currency":{"type":"string","description":"Devise de avg_price, la devise d’offre la plus fréquente","example":"USD","isRequired":true,"uniqueKey":"data.offer_summary.currency","typeLabel":"string"},"avg_price":{"oneOf":[{"type":"number","description":"Prix moyen des offres des produits de la marque","example":149.99,"isRequired":true,"uniqueKey":"data.offer_summary.avg_price.oneOf.0","typeLabel":"number"},{"type":"null","description":"Prix moyen des offres des produits de la marque","example":149.99,"isRequired":true,"uniqueKey":"data.offer_summary.avg_price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.offer_summary.avg_price","typeLabel":"number | null"}},"isRequired":true,"uniqueKey":"data.offer_summary","typeLabel":"object"},"top_own_products":{"type":"array","description":"Produits de la marque les plus affichés, par nombre d’apparitions décroissant","items":{"type":"object","required":["title","merchant","appearances","avg_position","avg_rating","image_url","product_url"],"properties":{"title":{"type":"string","description":"Titre du produit tel qu’affiché dans la réponse shopping","example":"Acme Trail Runner 3","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].title","typeLabel":"string"},"merchant":{"oneOf":[{"type":"string","description":"Revendeur du produit, si nommé dans la réponse","example":"Amazon","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].merchant.oneOf.0","typeLabel":"string"},{"type":"null","description":"Revendeur du produit, si nommé dans la réponse","example":"Amazon","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].merchant.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].merchant","typeLabel":"string | null"},"appearances":{"type":"integer","description":"Nombre de réponses d’achat contenant le produit","example":25,"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].appearances","typeLabel":"integer"},"avg_position":{"oneOf":[{"type":"number","description":"Position moyenne dans le carrousel, à partir de 1, faible étant meilleur ; null sans position connue","example":1.5,"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne dans le carrousel, à partir de 1, faible étant meilleur ; null sans position connue","example":1.5,"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_position","typeLabel":"number | null"},"avg_rating":{"oneOf":[{"type":"number","description":"Note moyenne affichée du produit, si disponible","example":4.5,"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_rating.oneOf.0","typeLabel":"number"},{"type":"null","description":"Note moyenne affichée du produit, si disponible","example":4.5,"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].avg_rating","typeLabel":"number | null"},"image_url":{"oneOf":[{"type":"string","description":"URL de l’image du produit dans la réponse","example":"https://example.com/trail-runner.jpg","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].image_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL de l’image du produit dans la réponse","example":"https://example.com/trail-runner.jpg","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].image_url","typeLabel":"string | null"},"product_url":{"oneOf":[{"type":"string","description":"URL de la fiche produit provenant de la réponse","example":"https://example.com/products/trail-runner-3","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].product_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL de la fiche produit provenant de la réponse","example":"https://example.com/products/trail-runner-3","isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].product_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_own_products.items.[INDEX].product_url","typeLabel":"string | null"}},"uniqueKey":"data.top_own_products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.top_own_products","typeLabel":"object[]"},"top_competitor_products":{"type":"array","description":"Produits concurrents les plus souvent affichés, par nombre d’apparitions décroissant","items":{"type":"object","required":["title","merchant","appearances","avg_position","avg_rating","image_url","product_url","competitor_id"],"properties":{"title":{"type":"string","description":"Titre du produit tel qu’affiché dans la réponse shopping","example":"Acme Trail Runner 3","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].title","typeLabel":"string"},"merchant":{"oneOf":[{"type":"string","description":"Revendeur du produit, si nommé dans la réponse","example":"Amazon","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].merchant.oneOf.0","typeLabel":"string"},{"type":"null","description":"Revendeur du produit, si nommé dans la réponse","example":"Amazon","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].merchant.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].merchant","typeLabel":"string | null"},"appearances":{"type":"integer","description":"Nombre de réponses d’achat contenant le produit","example":25,"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].appearances","typeLabel":"integer"},"avg_position":{"oneOf":[{"type":"number","description":"Position moyenne dans le carrousel, à partir de 1, faible étant meilleur ; null sans position connue","example":1.5,"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne dans le carrousel, à partir de 1, faible étant meilleur ; null sans position connue","example":1.5,"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_position","typeLabel":"number | null"},"avg_rating":{"oneOf":[{"type":"number","description":"Note moyenne affichée du produit, si disponible","example":4.5,"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_rating.oneOf.0","typeLabel":"number"},{"type":"null","description":"Note moyenne affichée du produit, si disponible","example":4.5,"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].avg_rating","typeLabel":"number | null"},"image_url":{"oneOf":[{"type":"string","description":"URL de l’image du produit dans la réponse","example":"https://example.com/trail-runner.jpg","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].image_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL de l’image du produit dans la réponse","example":"https://example.com/trail-runner.jpg","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].image_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].image_url","typeLabel":"string | null"},"product_url":{"oneOf":[{"type":"string","description":"URL de la fiche produit provenant de la réponse","example":"https://example.com/products/trail-runner-3","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].product_url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL de la fiche produit provenant de la réponse","example":"https://example.com/products/trail-runner-3","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].product_url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].product_url","typeLabel":"string | null"},"competitor_id":{"oneOf":[{"type":"string","description":"Concurrent auquel le produit est attribué","example":"123e4567-e89b-12d3-a456-426614174222","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].competitor_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Concurrent auquel le produit est attribué","example":"123e4567-e89b-12d3-a456-426614174222","isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].competitor_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.top_competitor_products.items.[INDEX].competitor_id","typeLabel":"string | null"}},"uniqueKey":"data.top_competitor_products.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.top_competitor_products","typeLabel":"object[]"},"competitor_breakdown":{"type":"array","description":"Classement concurrentiel : concurrents suivis apparaissant le plus dans les réponses d’achat","items":{"type":"object","required":["competitor_id","competitor_name","product_count","avg_position","avg_rating","response_count"],"properties":{"competitor_id":{"type":"string","format":"uuid","example":"123e4567-e89b-12d3-a456-426614174222","isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].competitor_id","typeLabel":"string\u003cuuid>"},"competitor_name":{"oneOf":[{"type":"string","description":"Nom du concurrent","example":"Rival Runners","isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].competitor_name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Nom du concurrent","example":"Rival Runners","isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].competitor_name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].competitor_name","typeLabel":"string | null"},"product_count":{"type":"integer","description":"Apparitions de produits attribuées au concurrent","example":30,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].product_count","typeLabel":"integer"},"avg_position":{"oneOf":[{"type":"number","description":"Position moyenne des produits concurrents dans les carrousels ; null sans position connue","example":3.5,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne des produits concurrents dans les carrousels ; null sans position connue","example":3.5,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_position","typeLabel":"number | null"},"avg_rating":{"oneOf":[{"type":"number","description":"Note moyenne affichée des produits concurrents","example":4.2,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_rating.oneOf.0","typeLabel":"number"},{"type":"null","description":"Note moyenne affichée des produits concurrents","example":4.2,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_rating.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].avg_rating","typeLabel":"number | null"},"response_count":{"type":"integer","description":"Réponses d’achat dans lesquelles le concurrent apparaît","example":15,"isRequired":true,"uniqueKey":"data.competitor_breakdown.items.[INDEX].response_count","typeLabel":"integer"}},"uniqueKey":"data.competitor_breakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.competitor_breakdown","typeLabel":"object[]"},"merchant_breakdown":{"type":"array","description":"Répartition des revendeurs des produits dans les réponses IA, propres et concurrents","items":{"type":"object","required":["merchant","own_count","competitor_count","own_avg_position","competitor_avg_position","own_response_count","competitor_response_count"],"properties":{"merchant":{"type":"string","example":"Amazon","isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].merchant","typeLabel":"string"},"own_count":{"type":"integer","description":"Apparitions de produits de marque chez ce revendeur","example":15,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].own_count","typeLabel":"integer"},"competitor_count":{"type":"integer","description":"Apparitions de produits concurrents chez ce revendeur","example":35,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].competitor_count","typeLabel":"integer"},"own_avg_position":{"oneOf":[{"type":"number","description":"Position moyenne des produits de la marque chez ce revendeur","example":2.8,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].own_avg_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne des produits de la marque chez ce revendeur","example":2.8,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].own_avg_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].own_avg_position","typeLabel":"number | null"},"competitor_avg_position":{"oneOf":[{"type":"number","description":"Position moyenne des produits concurrents de ce distributeur","example":3.6,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].competitor_avg_position.oneOf.0","typeLabel":"number"},{"type":"null","description":"Position moyenne des produits concurrents de ce distributeur","example":3.6,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].competitor_avg_position.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].competitor_avg_position","typeLabel":"number | null"},"own_response_count":{"type":"integer","description":"Réponses d’achat avec un produit de marque de ce revendeur","example":12,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].own_response_count","typeLabel":"integer"},"competitor_response_count":{"type":"integer","description":"Réponses d’achat avec un produit concurrent de ce revendeur","example":22,"isRequired":true,"uniqueKey":"data.merchant_breakdown.items.[INDEX].competitor_response_count","typeLabel":"integer"}},"uniqueKey":"data.merchant_breakdown.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.merchant_breakdown","typeLabel":"object[]"},"position_distribution":{"type":"array","description":"Répartition des classements : occupant de chaque position du carrousel","items":{"type":"object","required":["position","count","own_count","competitor_count"],"properties":{"position":{"type":"integer","description":"Position dans le carrousel à partir de 1","example":1,"isRequired":true,"uniqueKey":"data.position_distribution.items.[INDEX].position","typeLabel":"integer"},"count":{"type":"integer","description":"Apparitions de produits à cette position","example":40,"isRequired":true,"uniqueKey":"data.position_distribution.items.[INDEX].count","typeLabel":"integer"},"own_count":{"type":"integer","description":"Apparitions de produits de marque à cette position","example":12,"isRequired":true,"uniqueKey":"data.position_distribution.items.[INDEX].own_count","typeLabel":"integer"},"competitor_count":{"type":"integer","description":"Apparitions de produits concurrents à cette position","example":28,"isRequired":true,"uniqueKey":"data.position_distribution.items.[INDEX].competitor_count","typeLabel":"integer"}},"uniqueKey":"data.position_distribution.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.position_distribution","typeLabel":"object[]"},"price_comparison":{"type":"array","description":"Fourchette des prix d’offre des produits de marque et concurrents, par devise","items":{"type":"object","required":["category","currency","avg_price","min_price","max_price","product_count"],"properties":{"category":{"type":"string","enum":["own","competitor"],"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].category","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","example":"USD","isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].currency","typeLabel":"string"},"avg_price":{"oneOf":[{"type":"number","description":"Prix moyen des offres","example":149.99,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].avg_price.oneOf.0","typeLabel":"number"},{"type":"null","description":"Prix moyen des offres","example":149.99,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].avg_price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].avg_price","typeLabel":"number | null"},"min_price":{"oneOf":[{"type":"number","description":"Prix d’offre le plus bas","example":89,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].min_price.oneOf.0","typeLabel":"number"},{"type":"null","description":"Prix d’offre le plus bas","example":89,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].min_price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].min_price","typeLabel":"number | null"},"max_price":{"oneOf":[{"type":"number","description":"Prix d’offre le plus élevé","example":219,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].max_price.oneOf.0","typeLabel":"number"},{"type":"null","description":"Prix d’offre le plus élevé","example":219,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].max_price.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].max_price","typeLabel":"number | null"},"product_count":{"type":"integer","description":"Apparitions de produits avec un prix interprétable","example":80,"isRequired":true,"uniqueKey":"data.price_comparison.items.[INDEX].product_count","typeLabel":"integer"}},"uniqueKey":"data.price_comparison.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.price_comparison","typeLabel":"object[]"},"trend":{"type":"array","description":"Apparitions quotidiennes des produits, propres et concurrents","items":{"type":"object","required":["date","total_products","own_products","competitor_products","total_responses","responses_with_own"],"properties":{"date":{"type":"string","format":"date","example":"2026-08-01","isRequired":true,"uniqueKey":"data.trend.items.[INDEX].date","typeLabel":"string\u003cdate>"},"total_products":{"type":"integer","example":5,"isRequired":true,"uniqueKey":"data.trend.items.[INDEX].total_products","typeLabel":"integer"},"own_products":{"type":"integer","example":2,"isRequired":true,"uniqueKey":"data.trend.items.[INDEX].own_products","typeLabel":"integer"},"competitor_products":{"type":"integer","example":3,"isRequired":true,"uniqueKey":"data.trend.items.[INDEX].competitor_products","typeLabel":"integer"},"total_responses":{"type":"integer","description":"Réponses d’achat de ce jour","example":4,"isRequired":true,"uniqueKey":"data.trend.items.[INDEX].total_responses","typeLabel":"integer"},"responses_with_own":{"type":"integer","description":"Réponses d’achat de ce jour contenant un produit de la marque","example":2,"isRequired":true,"uniqueKey":"data.trend.items.[INDEX].responses_with_own","typeLabel":"integer"}},"uniqueKey":"data.trend.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.trend","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"data":{"summary":{"total_shopping_responses":50,"responses_with_own_products":20,"appearance_rate":40,"total_products":150,"own_products":40,"competitor_products":110,"avg_own_position":2.5,"avg_competitor_position":4.2},"offer_summary":{"total_offers":200,"products_with_offers":80,"competitor_offers":60,"currency":"USD","avg_price":149.99},"top_own_products":[{"title":"Acme Trail Runner 3","merchant":"Amazon","appearances":25,"avg_position":1.5,"avg_rating":4.5,"image_url":"https://example.com/trail-runner.jpg","product_url":"https://example.com/products/trail-runner-3"}],"top_competitor_products":[{"title":"Rival Speed 2","merchant":"Walmart","appearances":18,"avg_position":2.2,"avg_rating":4.1,"image_url":null,"product_url":"https://rival.example/speed-2","competitor_id":"123e4567-e89b-12d3-a456-426614174222"}],"competitor_breakdown":[{"competitor_id":"123e4567-e89b-12d3-a456-426614174222","competitor_name":"Rival Runners","product_count":30,"avg_position":3.5,"avg_rating":4.2,"response_count":15}],"merchant_breakdown":[{"merchant":"Amazon","own_count":15,"competitor_count":35,"own_avg_position":2.8,"competitor_avg_position":3.6,"own_response_count":12,"competitor_response_count":22}],"position_distribution":[{"position":1,"count":40,"own_count":12,"competitor_count":28},{"position":2,"count":38,"own_count":10,"competitor_count":28}],"price_comparison":[{"category":"own","currency":"USD","avg_price":149.99,"min_price":89,"max_price":219,"product_count":80},{"category":"competitor","currency":"USD","avg_price":132.5,"min_price":59,"max_price":249,"product_count":60}],"trend":[{"date":"2026-08-01","total_products":5,"own_products":2,"competitor_products":3,"total_responses":4,"responses_with_own":2}]}},"examples":{"Example":{"title":"Example","value":{"data":{"summary":{"total_shopping_responses":50,"responses_with_own_products":20,"appearance_rate":40,"total_products":150,"own_products":40,"competitor_products":110,"avg_own_position":2.5,"avg_competitor_position":4.2},"offer_summary":{"total_offers":200,"products_with_offers":80,"competitor_offers":60,"currency":"USD","avg_price":149.99},"top_own_products":[{"title":"Acme Trail Runner 3","merchant":"Amazon","appearances":25,"avg_position":1.5,"avg_rating":4.5,"image_url":"https://example.com/trail-runner.jpg","product_url":"https://example.com/products/trail-runner-3"}],"top_competitor_products":[{"title":"Rival Speed 2","merchant":"Walmart","appearances":18,"avg_position":2.2,"avg_rating":4.1,"image_url":null,"product_url":"https://rival.example/speed-2","competitor_id":"123e4567-e89b-12d3-a456-426614174222"}],"competitor_breakdown":[{"competitor_id":"123e4567-e89b-12d3-a456-426614174222","competitor_name":"Rival Runners","product_count":30,"avg_position":3.5,"avg_rating":4.2,"response_count":15}],"merchant_breakdown":[{"merchant":"Amazon","own_count":15,"competitor_count":35,"own_avg_position":2.8,"competitor_avg_position":3.6,"own_response_count":12,"competitor_response_count":22}],"position_distribution":[{"position":1,"count":40,"own_count":12,"competitor_count":28},{"position":2,"count":38,"own_count":10,"competitor_count":28}],"price_comparison":[{"category":"own","currency":"USD","avg_price":149.99,"min_price":89,"max_price":219,"product_count":80},{"category":"competitor","currency":"USD","avg_price":132.5,"min_price":59,"max_price":249,"product_count":60}],"trend":[{"date":"2026-08-01","total_products":5,"own_products":2,"competitor_products":3,"total_responses":4,"responses_with_own":2}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"fc1eae9c-ec4e-4940-b088-569805169993":{"description":"Requête incorrecte — paramètres invalides","content":{"application/json":{"schema":{"type":"object","description":"Objet de réponse d’erreur","required":["error"],"properties":{"error":{"type":"string","description":"Message expliquant l’erreur","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_website_id":{"title":"missing_website_id","value":{"error":"website_id: Required"}},"missing_start_date":{"title":"missing_start_date","value":{"error":"filters.start_date: Invalid input: expected string, received undefined"}},"unsupported_filter":{"title":"unsupported_filter","value":{"error":"filters: Unrecognized key: \"prompt_ids\""}}},"exampleType":"examples"}},"exampleType":"examples"},"ab398c93-2798-4e93-a138-172b47bd5a11":{"description":"Non autorisé — clé API invalide ou absente","content":{"application/json":{"schema":{"type":"object","description":"Objet de réponse d’erreur","required":["error"],"properties":{"error":{"type":"string","description":"Message expliquant l’erreur","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"},"7da89a53-6089-4def-9649-27d7a7379fbe":{"description":"Interdit — aucun accès au site, concurrent d’un autre site ou organisation sur Free","content":{"application/json":{"schema":{"type":"object","description":"Objet de réponse d’erreur","required":["error"],"properties":{"error":{"type":"string","description":"Message expliquant l’erreur","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"website":{"title":"website","value":{"error":"Unauthorized access to this website"}},"competitors":{"title":"competitors","value":{"error":"Unauthorized access to these competitors"}},"free_plan":{"title":"free_plan","value":{"error":"Shopping requires a paid plan"}}},"exampleType":"examples"}},"exampleType":"examples"},"2f91ec0a-27ff-4078-996b-4a4b754575ee":{"description":"Site introuvable","content":{"application/json":{"schema":{"type":"object","description":"Objet de réponse d’erreur","required":["error"],"properties":{"error":{"type":"string","description":"Message expliquant l’erreur","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Website not found"},"examples":{"Example":{"title":"Example","value":{"error":"Website not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"cb9da8df-3287-4ebf-9543-d3da2dd72e22":{"description":"Erreur interne du serveur","content":{"application/json":{"schema":{"type":"object","description":"Objet de réponse d’erreur","required":["error"],"properties":{"error":{"type":"string","description":"Message expliquant l’erreur","example":"Unauthorized","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"6ee4283f-699a-4158-8ccd-c239bbdb0bb4":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api).","scopes":[],"schemeName":"apiKey"}}},"servers":{"e7dec90e-429a-4746-8471-ec9f07e264b7":{"url":"https://api.athenahq.ai","description":"Serveur de production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api).","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"fr/api-reference/openapi.json"},"subdomain":"athenahq","siteName":"AthenaHQ","title":"Métriques d’achat - AthenaHQ","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/metrics/shopping-metrics","matchLevel":1},"es":{"href":"/es/api-reference/metrics/shopping-metrics","matchLevel":1},"fr":{"href":"/fr/api-reference/metrics/shopping-metrics","matchLevel":0}}},"lastModified":"2026-11-03T03:20:36.948Z","originalFileLocation":"fr/api-reference/metrics/shopping-metrics.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Métriques d’achat - AthenaHQ\">\u003cmeta data-mint-head property=\"og:description\" content=\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AthenaHQ\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Shopping\u0026amp;title=M%C3%A9triques+d%E2%80%99achat\u0026amp;description=Renvoie+le+tableau+de+bord+Shopping+Insights+d%E2%80%99un+site+web+sur+une+p%C3%A9riode+%3A+fr%C3%A9quence+d%E2%80%99apparition+des+produits+de+la+marque+dans+les+r%C3%A9ponses+shopping+IA+%28car\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=e32877b476d68a09edf2c6b505f7bfa311adbe6fddb407c883d20d8bf78d6647\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Métriques d’achat - AthenaHQ\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Shopping\u0026amp;title=M%C3%A9triques+d%E2%80%99achat\u0026amp;description=Renvoie+le+tableau+de+bord+Shopping+Insights+d%E2%80%99un+site+web+sur+une+p%C3%A9riode+%3A+fr%C3%A9quence+d%E2%80%99apparition+des+produits+de+la+marque+dans+les+r%C3%A9ponses+shopping+IA+%28car\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=e32877b476d68a09edf2c6b505f7bfa311adbe6fddb407c883d20d8bf78d6647\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f39f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/fr/api-reference/metrics/shopping-metrics.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.athenahq.ai/api-reference/metrics/shopping-metrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.athenahq.ai/es/api-reference/metrics/shopping-metrics\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.athenahq.ai/api-reference/metrics/shopping-metrics\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.athenahq.ai/#organization\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.athenahq.ai#website\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics#webpage\",\"url\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\",\"name\":\"Métriques d’achat\",\"description\":\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.\",\"dateModified\":\"2026-11-03T03:20:36.948Z\",\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Analyses\",\"item\":\"https://docs.athenahq.ai/fr/api-reference/attributes/list-attributes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Métriques d’achat\",\"item\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics#apireference\",\"headline\":\"Métriques d’achat\",\"name\":\"Métriques d’achat\",\"description\":\"Renvoie le tableau de bord Shopping Insights d’un site web sur une période : fréquence d’apparition des produits de la marque dans les réponses shopping IA (carrousels de produits) face aux concurrents, position et prix moyens, principaux produits propres et concurrents, classement des concurrents, répartition par distributeur, distribution des positions, comparaison des prix et tendance quotidienne des apparitions. Un seul appel renvoie tous les blocs affichés sur la page Shopping de l’application. models accepte chatgpt, ai_mode, gemini, perplexity et copilot. Nécessite une offre payante.\",\"url\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.athenahq.ai/fr/api-reference/metrics/shopping-metrics#webpage\"},\"dateModified\":\"2026-11-03T03:20:36.948Z\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AthenaHQ\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AthenaHQ","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/metrics/shopping-metrics"}]},{"language":"es","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Soporte"}],"primary":{"type":"button","label":"Panel","href":"https://app.athenahq.ai/settings/api"}},"pages":[{"title":"es","href":"/es/api-reference/metrics/shopping-metrics"}]},{"language":"fr","default":false,"navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Assistance"}],"primary":{"type":"button","label":"Tableau de bord","href":"https://app.athenahq.ai/settings/api"}},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/fr/getting-started/setup"}]},{"tab":"Référence de l’API","icon":"code","groups":[{"group":"Vue d’ensemble","pages":[{"title":"Introduction","icon":"book","href":"/fr/api-reference/introduction"},{"title":"Authentification","icon":"key","href":"/fr/api-reference/authentication"},{"title":"Authentification unique (SSO)","icon":"lock","href":"/fr/api-reference/sso"},{"title":"Limites de requêtes","icon":"gauge","href":"/fr/api-reference/rate-limits"},{"title":"Journal des modifications","icon":"clock-rotate-left","href":"/fr/api-reference/changelog"}]},{"group":"Intégrations","pages":[{"title":"Serveur MCP","icon":"plug","href":"/fr/api-reference/mcp"},{"title":"Looker Studio","icon":"chart-line","href":"/fr/api-reference/looker-studio"},{"title":"Power BI et Microsoft Fabric","icon":"chart-column","href":"/fr/api-reference/powerbi-fabric"},{"title":"Exportations des vues enregistrées","icon":"file-export","href":"/fr/api-reference/saved-view-exports"}]},{"group":"Ressources principales","pages":[{"group":"Utilitaires","pages":[{"title":"Valider une clé API","openapi":"fr/api-reference/openapi.json get /api/validate-api-key","href":"/fr/api-reference/basics/validate-api-key"},{"title":"Récupérer la période","openapi":"fr/api-reference/openapi.json get /api/v1/date-range","href":"/fr/api-reference/basics/get-date-range"},{"title":"Interroger les données d’un rapport Looker Studio","openapi":"fr/api-reference/openapi.json post /api/v1/looker-studio/data","href":"/fr/api-reference/analytics/query-looker-studio-report-data"}]},{"group":"Sites web","pages":[{"title":"Obtenir les sites","openapi":"fr/api-reference/openapi.json get /api/v1/websites","href":"/fr/api-reference/basics/get-websites"},{"title":"Créer un site","openapi":"fr/api-reference/openapi.json post /api/v1/websites","href":"/fr/api-reference/basics/create-website"},{"title":"Provisionner un site","openapi":"fr/api-reference/openapi.json post /api/v1/websites/provision","href":"/fr/api-reference/basics/provision-website"},{"title":"Mettre à jour un site web","openapi":"fr/api-reference/openapi.json patch /api/v1/websites/{website_id}","href":"/fr/api-reference/basics/update-website"},{"title":"Supprimer un site web","openapi":"fr/api-reference/openapi.json post /api/v1/websites/{website_id}/delete","href":"/fr/api-reference/basics/delete-website"},{"title":"Restaurer un site web","openapi":"fr/api-reference/openapi.json post /api/v1/websites/{website_id}/restore","href":"/fr/api-reference/basics/restore-website"}]},{"group":"Prompts","pages":[{"title":"Obtenir les prompts","openapi":"fr/api-reference/openapi.json get /api/v1/prompts","href":"/fr/api-reference/basics/get-prompts"},{"title":"Créer des prompts","openapi":"fr/api-reference/openapi.json post /api/v1/prompts","href":"/fr/api-reference/basics/create-prompts"},{"title":"Modifier un prompt","openapi":"fr/api-reference/openapi.json patch /api/v1/prompts/{prompt_id}","href":"/fr/api-reference/basics/update-prompt"},{"title":"Mettre en pause ou réactiver les prompts","openapi":"fr/api-reference/openapi.json patch /api/v1/prompts/status","href":"/fr/api-reference/basics/pause-or-unpause-prompts"},{"title":"Supprimer un prompt","openapi":"fr/api-reference/openapi.json delete /api/v1/prompts/{prompt_id}","href":"/fr/api-reference/basics/delete-prompt"},{"title":"Obtenir les étiquettes de prompts","openapi":"fr/api-reference/openapi.json get /api/v1/prompt-tags","href":"/fr/api-reference/basics/get-prompt-tags"},{"title":"Lister les planifications de prompts","openapi":"fr/api-reference/openapi.json get /api/v1/prompt-schedules","href":"/fr/api-reference/basics/list-prompt-schedules"}]},{"group":"Clés API","pages":[{"title":"Lister les clés API","openapi":"fr/api-reference/openapi.json get /api/v1/api-keys","href":"/fr/api-reference/basics/list-api-keys"}]},{"group":"Activité","pages":[{"title":"Lister l’activité","openapi":"fr/api-reference/openapi.json get /api/v1/activity","href":"/fr/api-reference/basics/list-activity"}]},{"group":"Sujets","pages":[{"title":"Obtenir les sujets","openapi":"fr/api-reference/openapi.json get /api/v1/topics","href":"/fr/api-reference/basics/get-topics"},{"title":"Créer un sujet","openapi":"fr/api-reference/openapi.json post /api/v1/topics","href":"/fr/api-reference/basics/create-topic"},{"title":"Modifier un sujet","openapi":"fr/api-reference/openapi.json patch /api/v1/topics/{topic_id}","href":"/fr/api-reference/basics/update-topic"},{"title":"Supprimer un sujet","openapi":"fr/api-reference/openapi.json delete /api/v1/topics/{topic_id}","href":"/fr/api-reference/basics/delete-topic"}]},{"group":"Personas et concurrents","pages":[{"title":"Récupérer les personas","openapi":"fr/api-reference/openapi.json get /api/v1/personas","href":"/fr/api-reference/basics/get-personas"},{"title":"Récupérer les concurrents","openapi":"fr/api-reference/openapi.json get /api/v1/competitors","href":"/fr/api-reference/basics/get-competitors"}]},{"group":"Emplacements","pages":[{"title":"Obtenir les emplacements","openapi":"fr/api-reference/openapi.json get /api/v1/locations","href":"/fr/api-reference/basics/get-locations"},{"title":"Créer un emplacement","openapi":"fr/api-reference/openapi.json post /api/v1/locations","href":"/fr/api-reference/basics/create-location"},{"title":"Modifier un emplacement","openapi":"fr/api-reference/openapi.json patch /api/v1/locations/{location_id}","href":"/fr/api-reference/basics/update-location"},{"title":"Supprimer un emplacement","openapi":"fr/api-reference/openapi.json delete /api/v1/locations/{location_id}","href":"/fr/api-reference/basics/delete-location"}]},{"group":"Réponses","pages":[{"title":"Interroger les réponses","openapi":"fr/api-reference/openapi.json post /api/v1/responses","href":"/fr/api-reference/basics/query-responses"},{"title":"Lancer la collecte de réponses","openapi":"fr/api-reference/openapi.json post /api/v1/response-streaming/start","href":"/fr/api-reference/basics/start-response-streaming"},{"title":"Obtenir le statut de collecte des réponses","openapi":"fr/api-reference/openapi.json get /api/v1/response-streaming/status","href":"/fr/api-reference/basics/get-response-streaming-status"}]},{"group":"Vues enregistrées","pages":[{"title":"Obtenir les vues enregistrées","openapi":"fr/api-reference/openapi.json get /api/v1/saved-views","href":"/fr/api-reference/basics/get-saved-views"},{"title":"Obtenir les vues enregistrées du groupe","openapi":"fr/api-reference/openapi.json get /api/v1/group-saved-views","href":"/fr/api-reference/basics/get-group-saved-views"}]}]},{"group":"Analyses","pages":[{"group":"Attributs","pages":[{"title":"Lister les attributs","openapi":"fr/api-reference/openapi.json get /api/v1/attributes","href":"/fr/api-reference/attributes/list-attributes"},{"title":"Métriques cumulées des attributs","openapi":"fr/api-reference/openapi.json post /api/v1/attributes/cumulative","href":"/fr/api-reference/attributes/cumulative-attribute-metrics"},{"title":"Métriques d’attributs concurrentiels","openapi":"fr/api-reference/openapi.json post /api/v1/attributes/competitors","href":"/fr/api-reference/attributes/competitor-attribute-metrics"},{"title":"Série chronologique des attributs","openapi":"fr/api-reference/openapi.json post /api/v1/attributes/time-series","href":"/fr/api-reference/attributes/attribute-time-series"},{"title":"Observations d’attributs","openapi":"fr/api-reference/openapi.json post /api/v1/attributes/observations","href":"/fr/api-reference/attributes/attribute-observations"}]},{"group":"Part de voix","pages":[{"title":"Part de voix cumulée","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/share-of-voice/cumulative","href":"/fr/api-reference/metrics/cumulative-share-of-voice"},{"title":"Évolution de la part de voix","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/share-of-voice/time-series","href":"/fr/api-reference/metrics/share-of-voice-over-time"}]},{"group":"Taux de mention","pages":[{"title":"Taux de mention cumulé","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/mention-rate/cumulative","href":"/fr/api-reference/metrics/cumulative-mention-rate"},{"title":"Évolution du taux de mention","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/mention-rate/time-series","href":"/fr/api-reference/metrics/mention-rate-over-time"}]},{"group":"Taux de citation","pages":[{"title":"Taux de citation cumulé","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/citation-rate/cumulative","href":"/fr/api-reference/metrics/cumulative-citation-rate"},{"title":"Évolution du taux de citation","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/citation-rate/time-series","href":"/fr/api-reference/metrics/citation-rate-over-time"}]},{"group":"Position","pages":[{"title":"Position cumulée","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/position/cumulative","href":"/fr/api-reference/metrics/cumulative-position"},{"title":"Position au fil du temps","description":"Renvoie la répartition quotidienne des positions sur la période, avec les métriques de votre marque et des concurrents.","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/position/time-series","href":"/fr/api-reference/metrics/position-over-time"}]},{"group":"Shopping","pages":[{"title":"Métriques d’achat","openapi":"fr/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/fr/api-reference/metrics/shopping-metrics"}]},{"group":"Valeur de la recherche IA","pages":[{"title":"AI Search Value","description":"Consultez une fourchette de la valeur mensuelle estimée en dollars de la présence d’un site dans les réponses de recherche IA, fondée sur l’économie des mots-clés Google.","icon":"money-bill-trend-up","href":"/fr/api-reference/ai-search-value"},{"title":"Obtenir la valeur de recherche IA","openapi":"fr/api-reference/openapi.json get /api/v1/ai-search-value","href":"/fr/api-reference/ai-search-value/get-ai-search-value"}]}]},{"group":"Contenu et connaissances","pages":[{"group":"Content Hub","pages":[{"title":"Répertorier les feuilles de Content Hub","openapi":"fr/api-reference/openapi.json get /api/v1/content/sheets","href":"/fr/api-reference/content/list-content-hub-sheets"},{"title":"Répertorier le contenu suivi","openapi":"fr/api-reference/openapi.json post /api/v1/content","href":"/fr/api-reference/content/list-tracked-content"},{"title":"Lister les contenus","openapi":"fr/api-reference/openapi.json get /api/v1/content/items","href":"/fr/api-reference/content/list-content-items"},{"title":"Obtenir le détail du contenu","openapi":"fr/api-reference/openapi.json get /api/v1/content/{content_id}","href":"/fr/api-reference/content/get-content-detail"},{"title":"Détail des citations par prompt et contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/prompts","href":"/fr/api-reference/content/per-content-prompt-citation-breakdown"},{"title":"Lancer le pipeline de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/generate","href":"/fr/api-reference/content/start-content-pipeline"},{"title":"Obtenir le statut du pipeline de contenu","openapi":"fr/api-reference/openapi.json get /api/v1/content/{content_id}/status","href":"/fr/api-reference/content/get-content-pipeline-status"},{"title":"Obtenir un brouillon de contenu","openapi":"fr/api-reference/openapi.json get /api/v1/content/{content_id}/draft","href":"/fr/api-reference/content/get-content-draft"},{"title":"Réviser le brief de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/brief/revise","href":"/fr/api-reference/content/revise-content-brief"},{"title":"Approuver le brief de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/brief/approve","href":"/fr/api-reference/content/approve-content-brief"},{"title":"Réviser un brouillon de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/revise","href":"/fr/api-reference/content/revise-content-draft"},{"title":"Modifier un brouillon de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/edit","href":"/fr/api-reference/content/edit-content-draft"},{"title":"Lister les versions de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/versions","href":"/fr/api-reference/content/list-content-versions"},{"title":"Obtenir une version de contenu","openapi":"fr/api-reference/openapi.json get /api/v1/content/{content_id}/versions/{version_id}","href":"/fr/api-reference/content/get-content-version"},{"title":"Restaurer une version de contenu","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/versions/{version_id}/restore","href":"/fr/api-reference/content/restore-content-version"},{"title":"Marquer un contenu comme publié","openapi":"fr/api-reference/openapi.json post /api/v1/content/{content_id}/publish","href":"/fr/api-reference/content/mark-content-as-published"},{"title":"Suivre des URL externes","openapi":"fr/api-reference/openapi.json post /api/v1/content/track","href":"/fr/api-reference/content/track-external-urls"},{"title":"Renommer le contenu","openapi":"fr/api-reference/openapi.json patch /api/v1/content/{content_id}","href":"/fr/api-reference/content/rename-content"},{"title":"Supprimer un contenu","openapi":"fr/api-reference/openapi.json delete /api/v1/content/{content_id}","href":"/fr/api-reference/content/delete-content"}]},{"group":"Recommandations SEO","pages":[{"title":"Soumettre des recommandations SEO","openapi":"fr/api-reference/openapi.json post /api/v1/seo/recommendations","href":"/fr/api-reference/seo-recommendations/submit-seo-recommendations"},{"title":"Récupérer la tâche de recommandations SEO","openapi":"fr/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}","href":"/fr/api-reference/seo-recommendations/get-seo-recommendation-job"}]},{"group":"Base de connaissances","pages":[{"title":"Rechercher des faits de marque","openapi":"fr/api-reference/openapi.json get /api/v1/knowledge-base/facts/search","href":"/fr/api-reference/knowledge-base/search-brand-facts"},{"title":"Obtenir les faits de marque","openapi":"fr/api-reference/openapi.json get /api/v1/knowledge-base/facts","href":"/fr/api-reference/knowledge-base/get-brand-facts"},{"title":"Obtenir les piliers","openapi":"fr/api-reference/openapi.json get /api/v1/knowledge-base/pillars","href":"/fr/api-reference/knowledge-base/get-pillars"},{"title":"Obtenir le document d’un pilier","openapi":"fr/api-reference/openapi.json get /api/v1/knowledge-base/pillars/{pillar_id}/document","href":"/fr/api-reference/knowledge-base/get-pillar-document"},{"title":"Ajouter des faits de marque","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/facts","href":"/fr/api-reference/knowledge-base/add-brand-facts"},{"title":"Modifier un fait de marque","openapi":"fr/api-reference/openapi.json patch /api/v1/knowledge-base/facts/{fact_id}","href":"/fr/api-reference/knowledge-base/update-brand-fact"},{"title":"Supprimer des faits de marque","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/facts/delete","href":"/fr/api-reference/knowledge-base/delete-brand-facts"},{"title":"Déplacer des faits de marque","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/facts/move","href":"/fr/api-reference/knowledge-base/move-brand-facts"},{"title":"Créer un pilier","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/pillars","href":"/fr/api-reference/knowledge-base/create-pillar"},{"title":"Modifier un pilier","openapi":"fr/api-reference/openapi.json patch /api/v1/knowledge-base/pillars/{pillar_id}","href":"/fr/api-reference/knowledge-base/update-pillar"},{"title":"Supprimer les piliers","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/pillars/delete","href":"/fr/api-reference/knowledge-base/delete-pillars"},{"title":"Fusionner les piliers","openapi":"fr/api-reference/openapi.json post /api/v1/knowledge-base/pillars/merge","href":"/fr/api-reference/knowledge-base/merge-pillars"}]},{"group":"Pitch Workspace","pages":[{"title":"Créer un rapport de proposition","openapi":"fr/api-reference/openapi.json post /api/v1/pitches","href":"/fr/api-reference/pitch-workspace/create-a-pitch-report"},{"title":"Répertorier les pitchs","openapi":"fr/api-reference/openapi.json get /api/v1/pitches","href":"/fr/api-reference/pitch-workspace/list-pitches"},{"title":"Obtenir un rapport de proposition","openapi":"fr/api-reference/openapi.json get /api/v1/pitches/{pitch_id}","href":"/fr/api-reference/pitch-workspace/get-pitch-report"}]},{"group":"Sources","pages":[{"title":"Lister les sources par domaine racine","openapi":"fr/api-reference/openapi.json post /api/v1/sources","href":"/fr/api-reference/sources/list-sources-by-root-domain"},{"title":"Répertorier les pages sources (par URL)","openapi":"fr/api-reference/openapi.json post /api/v1/source-pages","href":"/fr/api-reference/sources/list-source-pages-per-url"}]}]},{"group":"Administration","pages":[{"group":"Groupes","pages":[{"title":"Lister les groupes","openapi":"fr/api-reference/openapi.json get /api/v1/groups","href":"/fr/api-reference/groups/list-groups"},{"title":"Créer un groupe","openapi":"fr/api-reference/openapi.json post /api/v1/groups","href":"/fr/api-reference/groups/create-group"},{"title":"Obtenir un groupe","openapi":"fr/api-reference/openapi.json get /api/v1/groups/{group_id}","href":"/fr/api-reference/groups/get-group"},{"title":"Modifier un groupe","openapi":"fr/api-reference/openapi.json patch /api/v1/groups/{group_id}","href":"/fr/api-reference/groups/update-group"}]},{"group":"Invitations","pages":[{"title":"Créer une invitation","openapi":"fr/api-reference/openapi.json post /api/v1/invites","href":"/fr/api-reference/team-management/create-invite"},{"title":"Inviter en masse dans des sites web ou groupes","openapi":"fr/api-reference/openapi.json post /api/v1/invites/bulk","href":"/fr/api-reference/team-management/bulk-invite-to-websites-or-groups"},{"title":"Révoquer une invitation à l’organisation","openapi":"fr/api-reference/openapi.json delete /api/v1/invites/org/{invite_id}","href":"/fr/api-reference/team-management/revoke-organization-invite"},{"title":"Révoquer une invitation au site","openapi":"fr/api-reference/openapi.json delete /api/v1/invites/website/{invite_id}","href":"/fr/api-reference/team-management/revoke-website-invite"}]},{"group":"Membres","pages":[{"title":"Lister les membres de l’organisation","openapi":"fr/api-reference/openapi.json get /api/v1/organizations/members","href":"/fr/api-reference/team-management/list-organization-members"},{"title":"Lister les membres du site","openapi":"fr/api-reference/openapi.json get /api/v1/websites/{website_id}/members","href":"/fr/api-reference/team-management/list-website-members"},{"title":"Lister les membres du groupe","openapi":"fr/api-reference/openapi.json get /api/v1/groups/{group_id}/members","href":"/fr/api-reference/team-management/list-group-members"},{"title":"Rechercher un utilisateur par e-mail","openapi":"fr/api-reference/openapi.json post /api/v1/users/by-email","href":"/fr/api-reference/team-management/look-up-user-by-email"},{"title":"Répertorier les sites web de l’utilisateur","openapi":"fr/api-reference/openapi.json get /api/v1/users/{user_id}/websites","href":"/fr/api-reference/team-management/list-user-websites"},{"title":"Retirer un utilisateur de sites","openapi":"fr/api-reference/openapi.json delete /api/v1/users/{user_id}/websites","href":"/fr/api-reference/team-management/remove-user-from-websites"},{"title":"Mettre à jour le rôle d’un membre de l’organisation","openapi":"fr/api-reference/openapi.json patch /api/v1/organizations/members/{user_id}","href":"/fr/api-reference/team-management/update-organization-member-role"},{"title":"Modifier le rôle d’un membre du site","openapi":"fr/api-reference/openapi.json patch /api/v1/websites/{website_id}/members/{user_id}","href":"/fr/api-reference/team-management/update-website-member-role"},{"title":"Modifier le rôle d’un membre de groupe","openapi":"fr/api-reference/openapi.json patch /api/v1/groups/{group_id}/members/{user_id}","href":"/fr/api-reference/team-management/update-group-member-role"},{"title":"Retirer l’accès d’un membre de groupe","openapi":"fr/api-reference/openapi.json delete /api/v1/groups/{group_id}/members/{user_id}","href":"/fr/api-reference/team-management/remove-group-member-access"},{"title":"Retirer un membre de l’organisation","openapi":"fr/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}","href":"/fr/api-reference/team-management/remove-organization-member"},{"title":"Retirer un membre du site","openapi":"fr/api-reference/openapi.json delete /api/v1/websites/{website_id}/members/{user_id}","href":"/fr/api-reference/team-management/remove-website-member"}]},{"group":"Rôles","pages":[{"title":"Lister les rôles","openapi":"fr/api-reference/openapi.json get /api/v1/roles","href":"/fr/api-reference/team-management/list-roles"},{"title":"Créer un rôle personnalisé","openapi":"fr/api-reference/openapi.json post /api/v1/roles","href":"/fr/api-reference/team-management/create-custom-role"},{"title":"Obtenir un rôle","openapi":"fr/api-reference/openapi.json get /api/v1/roles/{role_id}","href":"/fr/api-reference/team-management/get-role"},{"title":"Modifier un rôle personnalisé","openapi":"fr/api-reference/openapi.json patch /api/v1/roles/{role_id}","href":"/fr/api-reference/team-management/update-custom-role"},{"title":"Supprimer un rôle personnalisé","openapi":"fr/api-reference/openapi.json delete /api/v1/roles/{role_id}","href":"/fr/api-reference/team-management/delete-custom-role"}]},{"group":"Facturation","pages":[{"title":"Obtenir les crédits du site","openapi":"fr/api-reference/openapi.json get /api/v1/credits/website","href":"/fr/api-reference/billing/get-website-credits"},{"title":"Obtenir les crédits de l’organisation","openapi":"fr/api-reference/openapi.json get /api/v1/credits/organization","href":"/fr/api-reference/billing/get-organization-credits"},{"title":"Récupérer les crédits du groupe","openapi":"fr/api-reference/openapi.json get /api/v1/credits/group","href":"/fr/api-reference/billing/get-group-credits"},{"title":"Obtenir l’abonnement du site","openapi":"fr/api-reference/openapi.json get /api/v1/subscriptions/website","href":"/fr/api-reference/billing/get-website-subscription"},{"title":"Résilier un abonnement","openapi":"fr/api-reference/openapi.json post /api/v1/subscriptions/cancel","href":"/fr/api-reference/billing/cancel-subscription"}]},{"group":"Accès de l’IA","pages":[{"title":"Accès des IA","icon":"robot","href":"/fr/api-reference/ai-access"},{"title":"Vérifier l’accessibilité IA d’un domaine","openapi":"fr/api-reference/openapi.json post /api/v1/ai-access/check","href":"/fr/api-reference/ai-access/check-ai-accessibility-for-a-domain"}]}]}]}]}]},"basePath":"","title":"Métriques d’achat - AthenaHQ","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}