Métriques

Données agrégées de visibilité, de Share of Voice, de citations et de position pour votre marque et ses concurrents, prêtes pour vos graphiques. Chaque endpoint accepte les filtres communs et le paramètre output décrits dans la section Concepts clés.

GET/metrics/timeseries

Renvoie des séries temporelles pour une ou plusieurs métriques, regroupées par acteur (votre projet et les concurrents sélectionnés). Les valeurs hebdomadaires et mensuelles suivent la sémantique de période décrite plus haut. Les filtres facultatifs prompt_type (intention de recherche) et brand_kind limitent chaque métrique à une catégorie de prompts.

GET/metrics/summary

Agrège par acteur et par métrique (total/min/max/last). Idéal pour des cartes KPI.

GET/metrics/prompt_summary

Renvoie des métriques agrégées par prompt, avec pagination (responses, mentions, citations, mention_rate, citation_rate, avg_mention_position, avg_position). Accepte breakdown=model pour ajouter la dimension modèle d’IA à chaque ligne et obtenir des métriques par prompt et par modèle. Paramètres : sort (responses, mentions, citations, mention_rate ou visibility, citation_rate, avg_mention_position, avg_position), sort_dir (asc/desc), breakdown (model), page, per_page (100 au maximum).

GET/metrics/sov

Share of Voice calculé à partir des mentions, aligné sur la page Vue d’ensemble.

  • over_time : pour chaque date, SOV = (actor_mentions / sum_all_mentions) × 100. Si la somme du jour vaut 0, la dernière valeur est conservée (report persistant).
  • current : utilise la dernière date dont le total n’est pas nul ; à défaut, les totaux de toute la période.
  • breakdown : les 4 premiers acteurs + une ligne agrégée Others (et une liste détaillée others).
  • periods et sample : chaque période indique le nombre de mentions (mentions) sur lequel ses parts ont été calculées, un indicateur partial, un niveau de confiance confidence (none sans mention, low en dessous de 30, medium en dessous de 100, high à partir de 100) et margin_of_error, la marge d’erreur à 95 % dans le pire des cas, en points de pourcentage (98 divisé par la racine carrée de mentions, soit environ 18 points à 30 mentions et 10 à 100 ; null sans mention). sample reprend la période sur laquelle les parts current ont été calculées, ou vaut null quand la fenêtre ne contient aucune mention.

GET/metrics/top_sources

Classe les domaines sources par nombre de réponses et par taux de mention moyen (% des exécutions dans lesquelles ce domaine apparaît).

  • Les données comprennent les sources non rejetées rattachées aux exécutions de prompts de la période, selon les filtres actuels.
  • total_responses : nombre d’exécutions de prompts distinctes qui ont produit au moins une source sur ce domaine.
  • avg_mention_rate (également renvoyé sous le nom avg_visibility) : (nombre de lignes de sources du domaine / total des exécutions) × 100.
  • Tri : sort=total_responses (par défaut), sort=avg_mention_rate ou sort=avg_visibility.
  • Pagination : page (>=1), per_page (20 par défaut, 100 maximum).
  • Filtre par domaine : query (LIKE insensible à la casse), par exemple query=github.