Lister les réponses
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/answers \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/answers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/answers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"answers": [
{
"id": "<string>",
"promptId": "<string>",
"promptText": "<string>",
"provider": "<string>",
"model": "<string>",
"persona": {},
"textPreview": "<string>",
"hasSelfMention": true,
"selfMentionPosition": 123,
"hasSelfSource": true,
"competitorsCount": 123,
"sourcesCount": 123,
"sentiment": {},
"createdAt": "<string>"
}
]
}Réponses
Lister les réponses
Récupérez les réponses générées par l’IA, filtrées par fournisseur, mentions de la marque et sources.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
answers
Lister les réponses
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/answers \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/answers"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/answers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"pagination": {
"total": 123,
"count": 123,
"limit": 123,
"offset": 123
},
"answers": [
{
"id": "<string>",
"promptId": "<string>",
"promptText": "<string>",
"provider": "<string>",
"model": "<string>",
"persona": {},
"textPreview": "<string>",
"hasSelfMention": true,
"selfMentionPosition": 123,
"hasSelfSource": true,
"competitorsCount": 123,
"sourcesCount": 123,
"sentiment": {},
"createdAt": "<string>"
}
]
}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.
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
Consultez Limites de débit pour la gestion des nouvelles tentatives.
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-xxxParamè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_PURCHASEstring
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 falseboolean
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 :
createdAtstring
défaut:"desc"
Ordre de tri :
asc ou descRéponse
boolean
Indique si la requête a réussi
object
array
Afficher Résumé de la réponse
Afficher Résumé de la réponse
string
Identifiant de la réponse
string
Identifiant du prompt associé
string
Texte du prompt associé
string
Nom du fournisseur IA
string
Nom du modèle IA
object | null
Persona enregistrée lors de la génération de la réponse (
id, name, description), ou nullstring
200 premiers caractères de la réponse
boolean
Indique si la marque est mentionnée
number
Position dans la liste des mentions (si elle est mentionnée)
boolean
Indique si le domaine de la marque est cité
number
Nombre de concurrents mentionnés
number
Nombre de sources citées
number | null
Sentiment de la mention SELF sur une échelle de 0 à 100, ou
nullstring
Horodatage de génération (ISO 8601)
Exemple de requête
curl "https://www.qwairy.co/api/v1/brands/YOUR_BRAND_ID/answers?hasSelfMention=true&limit=10" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 312,
"count": 1,
"limit": 10,
"offset": 0
},
"answers": [
{
"id": "answer_01",
"promptId": "prompt_01",
"promptText": "Which analytics platforms support warehouse exports?",
"provider": "ChatGPT",
"model": "GPT-6.1 Sol",
"textPreview": "Acme Analytics and Rival Labs both document warehouse export integrations...",
"hasSelfMention": true,
"selfMentionPosition": 3,
"hasSelfSource": false,
"competitorsCount": 5,
"sourcesCount": 3,
"sentiment": 82,
"createdAt": "2026-07-19T10:00:00.000Z"
}
]
}
Exemples de filtres
Trouver les réponses avec une mention SELF
GET /api/v1/brands/{brandId}/answers?hasSelfMention=true
Trouver les réponses avec une citation SELF
GET /api/v1/brands/{brandId}/answers?hasSelfSource=true
Combiner des filtres
# Answers with a SELF mention from the ChatGPT provider
GET /api/v1/brands/{brandId}/answers?provider=openai&hasSelfMention=true
hasSelfMention=true et filtrez le champ hasSelfSource renvoyé dans votre client.
Erreurs
| Statut | Signification |
|---|---|
400 | Paramètre de requête invalide |
401 | Jeton d’API manquant ou invalide |
404 | Marque introuvable ou inaccessible |
429 | Limite de débit dépassée ; respectez Retry-After |

