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 indicateurpartial, un niveau de confianceconfidence(nonesans mention,lowen dessous de 30,mediumen dessous de 100,highà partir de 100) etmargin_of_error, la marge d’erreur à 95 % dans le pire des cas, en points de pourcentage (98 divisé par la racine carrée dementions, soit environ 18 points à 30 mentions et 10 à 100 ;nullsans mention).samplereprend la période sur laquelle les partscurrentont été calculées, ou vautnullquand 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 nomavg_visibility) :(nombre de lignes de sources du domaine / total des exécutions) × 100.- Tri :
sort=total_responses(par défaut),sort=avg_mention_rateousort=avg_visibility. - Pagination :
page(>=1),per_page(20 par défaut, 100 maximum). - Filtre par domaine :
query(LIKEinsensible à la casse), par exemplequery=github.