Skip to main content
GET
Lister les réponses
Renvoie les réponses enregistrées des prompts suivis. La liste contient un aperçu du texte et les indicateurs SELF au niveau de la réponse ; utilisez Obtenir une réponse pour le détail complet.
Consultez Entités pour la structure complète de l’objet Answer, y compris le détail de CompetitorMention et de SourceCitation.
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. 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.
string
Filtre par fournisseur IA. Accepte plusieurs valeurs séparées par des virgules (par exemple chatgpt,claude).
string
Filtre par identifiant de Topic. 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
string
UUID de Personas enregistrées sur la réponse, séparés par des virgules. Utilisez default pour les réponses générées sans Persona, ou all pour ne pas filtrer.
string
Codes ISO 3166-1 alpha-2 du pays enregistré sur la réponse, séparés par des virgules (par exemple FR,BE). 50 codes au maximum ; un code invalide renvoie 400.
boolean
Filtre selon la présence d’une mention de la marque : true ou false
boolean
Utilisez true pour exiger une citation SELF. La route actuelle accepte false mais n’applique pas de filtre inverse.
number
défaut:"50"
Nombre maximal de réponses renvoyées (maximum : 100)
number
défaut:"0"
Décalage de pagination
string
défaut:"createdAt"
Champ de tri : createdAt
string
défaut:"desc"
Ordre de tri : asc ou desc

Réponse

boolean
Indique si la requête a réussi
object
array

Exemple de requête

Exemple de réponse

Exemples de filtres

Trouver les réponses avec une mention SELF

Trouver les réponses avec une citation SELF

Combiner des filtres

L’endpoint ne prend pas encore en charge de filtre inverse sur la citation SELF. Pour trouver les réponses qui mentionnent la marque sans la citer, demandez hasSelfMention=true et filtrez le champ hasSelfSource renvoyé dans votre client.

Erreurs

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