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.

Paramètres :
  • project_idobligatoire
  • viewproducts|merchants
  • owned
  • query
  • orderproducts : appearances, price, rating, title ; merchants : appearances, products, avg_price, avg_rating, merchant
  • direction
  • model
  • collection_id
  • country_code
  • language_code
  • prompt
  • prompt_type
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • output

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.

Paramètres :
  • project_idobligatoire
  • viewadvertisers|ads
  • owned
  • query
  • orderadvertisers : ads, prompts, avg_position, domain ; ads : recent, oldest, position
  • directionadvertisers uniquement ; ordre croissant par défaut pour avg_position et domain
  • model
  • collection_id
  • country_code
  • language_code
  • prompt
  • prompt_type
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • output

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.

Paramètres :
  • project_idobligatoire
  • owned
  • querynom ou adresse
  • orderappearances, business, rating, reviews, avg_position, prompts
  • direction
  • model
  • collection_id
  • country_code
  • language_code
  • prompt
  • prompt_type
  • brand_kind
  • range
  • from
  • to
  • page
  • per_page
  • output

Chaque réponse inclut aussi un bloc totals qui correspond aux cartes KPI de l’application.