Skip to main content
GET
Obtenir l’instantané de performance
Renvoie les indicateurs au niveau des réponses pour le périmètre sélectionné, ainsi que les ventilations par Topic, Tag, concurrent et source.
Cet endpoint renvoie des indicateurs agrégés. Consultez Competitor et Source pour les structures utilisées dans topCompetitors et topSources.

Formules des indicateurs

Comprendre le calcul des indicateurs est indispensable pour reproduire les résultats :
Le taux de mention et la couverture ont des dénominateurs différents. La réponse expose mentionCount, mentionTotal et responsesTotal, mais pas sovSelf ni sovTotal.
string
requis
Jeton bearer. Exemple : Bearer qw-api-xxx

Paramètres de chemin

string
requis
L’identifiant unique de la marque

Paramètres de requête

number
Nombre de jours à inclure dans l’instantané. Sans valeur, toutes les données sont renvoyées.
string
Date de début au format YYYY-MM-DD. Fournissez-la avec endDate ; une borne seule est actuellement ignorée. Choisissez soit period, soit la paire de dates complète.
string
Date de fin au format YYYY-MM-DD. Fournissez-la avec startDate ; une borne seule est actuellement ignorée. Ne combinez pas la paire de dates complète avec period.
Utilisez un seul mode de dates par requête. Combiner period avec une paire de dates personnalisées complète peut faire diverger le filtre appliqué des métadonnées period renvoyées.
string
Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple chatgpt,claude).
string
Filtre par identifiant de Topic (keywordId). Accepte plusieurs valeurs séparées par des virgules (par exemple id1,id2).
string
Filtre par identifiant de Tag. Accepte plusieurs valeurs séparées par des virgules (par exemple id1,id2).
string
Filtre par type de prompt : TOFU, MOFU, BOFU ou POST_PURCHASE

Réponse

boolean
Indique si la requête a réussi
object
object
object
object
array
Principaux concurrents par nombre de mentions
array
Principales sources par nombre de citations
array
array

Exemple de requête

Exemple de réponse

Erreurs

Consultez Limites de débit pour la gestion des nouvelles tentatives.