Shopping et publicités
Les formats commerciaux dans les réponses de l’IA : les fiches produits que renvoient les modèles, les emplacements payants affichés à côté, et les établissements locaux qu’ils listent pour les prompts à intention locale. Les fiches produits et les publicités nécessitent le forfait Scale ou supérieur ; les établissements locaux sont disponibles sur tous les forfaits. Les endpoints sont nommés d’après ce qu’ils mesurent, et non d’après l’assistant qui l’a renvoyé en premier : filtrez avec model au lieu de déduire le modèle du chemin.
GET/dimensions/shopping
Fiches produits renvoyées dans les réponses de l’IA. view=products (par défaut) renvoie une ligne par produit distinct, fusionné sur l’ensemble des exécutions, avec son nombre d’apparitions, sa fourchette de prix, sa note et l’indication qu’il s’agit ou non de votre produit. view=merchants renvoie une ligne par marchand. Un produit est identifié par son ID produit externe, ou à défaut par son titre lorsque la réponse n’en fournit aucun d’exploitable : le même produit est ainsi fusionné d’une exécution à l’autre au lieu d’être scindé en une ligne par réponse.
project_idobligatoireviewproducts|merchantsownedqueryorderproducts :appearances,price,rating,title; merchants :appearances,products,avg_price,avg_rating,merchantdirectionmodelcollection_idcountry_codelanguage_codepromptprompt_typebrand_kindrangefromtopageper_pageoutput
Chaque réponse inclut aussi un bloc totals qui correspond aux cartes KPI de l’application.
GET/dimensions/ads
Emplacements payants renvoyés dans les réponses de l’IA. view=advertisers (par défaut) renvoie une ligne par domaine annonceur, avec son nombre d’emplacements, le nombre de prompts concernés, sa position moyenne et sa meilleure position. view=ads renvoie chaque emplacement avec son titre, son extrait, sa position et le prompt qui l’a déclenché. La position 1 est le meilleur emplacement : une position moyenne plus faible est donc meilleure.
project_idobligatoireviewadvertisers|adsownedqueryorderadvertisers :ads,prompts,avg_position,domain; ads :recent,oldest,positiondirectionadvertisers uniquement ; ordre croissant par défaut pouravg_positionetdomainmodelcollection_idcountry_codelanguage_codepromptprompt_typebrand_kindrangefromtopageper_pageoutput
GET/dimensions/local_businesses
Établissements locaux (commerces, restaurants, services) listés dans les réponses de l’IA, à raison d’une ligne par établissement. Un établissement correspond à un nom à une adresse donnée : deux sites d’une même chaîne font donc deux lignes. Chaque ligne indique son nombre d’apparitions, le nombre de prompts qui l’ont listé, sa note moyenne et sa position moyenne dans la liste, son nombre d’avis, et s’il s’agit de votre établissement ou de celui d’un concurrent suivi. Disponible sur tous les forfaits.
project_idobligatoireownedquerynom ou adresseorderappearances,business,rating,reviews,avg_position,promptsdirectionmodelcollection_idcountry_codelanguage_codepromptprompt_typebrand_kindrangefromtopageper_pageoutput
Chaque réponse inclut aussi un bloc totals qui correspond aux cartes KPI de l’application.