Analyse des modèles d’IA

Les sections agrégées du rapport Analyse des modèles d’IA de l’application. Les trois endpoints rattachent chaque réponse au jour de sa création (fuseau horaire Europe/Madrid), comme l’application, et partagent un format d’acteur standard : { type, id, competitor_id, name, domain }, avec des domaines nus (sans protocole).

GET/reports/ai_model_insights/summary

Par modèle : nombre et part des mentions, nombre et part des citations, sentiment net de la marque avec le nombre brut de sentiments positifs et négatifs, totaux et parts de visibilité pondérée, ainsi qu’une matrice par acteur pour chacune de ces mesures.

Paramètres :
  • project_idobligatoire
  • range28 par défaut
  • from
  • to
  • granularityday|week|month
  • collection_id
  • country_code
  • language_code
  • prompt_type
  • brand_kindutilisez non_brand pour obtenir les mêmes chiffres que l’onglet Vue d’ensemble de la page Analyse des modèles d’IA et pour comparer équitablement la marque et ses concurrents
  • competitorsID de concurrents séparés par des virgules ; un ID inconnu → ERR_INVALID_PARAM

GET/reports/ai_model_insights/position_distribution

Comparaison de la répartition des positions utilisée dans le rapport Analyse des modèles d’IA : une ou deux séries de marques avec les totaux par tranche (Position 1, Position 2-3, Position 4-7, Position 8+) et, pour chaque tranche, une série temporelle prête pour un graphique.

Paramètres :
  • project_idobligatoire
  • range
  • from
  • to
  • granularity
  • collection_id
  • country_code
  • language_code
  • prompt_type
  • brand_kindutilisez non_brand pour une comparaison équitable, comme par défaut dans l’application
  • modellimite à un seul modèle
  • brand1
  • brand2ID des concurrents à comparer ; omettez brand1 pour comparer la marque du projet

GET/reports/ai_model_insights/ai_overview_results

Données agrégées sur la disponibilité des résultats Google AI Overviews : total des réponses AI Overviews, réponses avec résultats (no_result = false), taux de résultats, données de tendance prêtes pour un graphique et tableau paginé du taux de résultats par prompt.

Paramètres :
  • project_idobligatoire
  • range
  • from
  • tochaque réponse datée du jour de sa création, fuseau Europe/Madrid
  • collection_id
  • country_code
  • language_code
  • prompt_type
  • brand_kind
  • granularity
  • page
  • per_page