Lister les questions de suivi
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/follow-ups \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/follow-ups"
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}/follow-ups', 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,
"hasMore": true
},
"followUps": [
{
"id": "<string>",
"text": "<string>",
"kind": "<string>",
"position": 123,
"types": [
{}
],
"isMonitored": true,
"question": {},
"answer": {},
"createdAt": "<string>"
}
]
}Signaux
Lister les questions de suivi
Listez les questions suivantes suggérées par les fournisseurs IA après les réponses suivies, avec leur prompt source, leur réponse et leur statut de suivi.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
follow-ups
Lister les questions de suivi
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/follow-ups \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/follow-ups"
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}/follow-ups', 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,
"hasMore": true
},
"followUps": [
{
"id": "<string>",
"text": "<string>",
"kind": "<string>",
"position": 123,
"types": [
{}
],
"isMonitored": true,
"question": {},
"answer": {},
"createdAt": "<string>"
}
]
}Renvoie les questions de suivi suggérées par les fournisseurs après les réponses enregistrées, des plus récentes aux plus anciennes. Chaque ligne indique la question suggérée, sa position dans la liste du fournisseur, ses types d’intention, le prompt et la réponse sources, et si la même question est déjà un prompt suivi.
string
requis
Jeton bearer. Exemple :
Bearer qw-api-xxxGET /api/v1/brands/{brandId}/follow-ups
Paramètres de chemin
string
requis
L’identifiant unique de la marque
Paramètres de requête
number
Nombre de jours à inclure, selon la date de la réponse. Sans valeur, toutes les données sont renvoyées.
string
Date de début incluse, au format
YYYY-MM-DD. Prime sur period.string
Date de fin incluse, au format
YYYY-MM-DD.string
Filtre par un ou plusieurs alias de fournisseurs ou identifiants de modèles, séparés par des virgules.
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_PURCHASEstring
UUID de Personas enregistrées sur la réponse source, 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 source, séparés par des virgules (par exemple
FR,BE). 50 codes au maximum ; un code invalide renvoie 400.number
défaut:"50"
Nombre maximal de questions de suivi renvoyées (maximum : 100)
number
défaut:"0"
Nombre de résultats à ignorer pour la pagination
Réponse
boolean
Indique si la requête a réussi
object
array
Afficher Objet question de suivi
Afficher Objet question de suivi
string
Identifiant de la question de suivi
string
La question suggérée, ou le message de suite guidée
string
SUGGESTION pour un prompt que le moteur propose tel quel ; GUIDED_CONTINUATION pour le message que ChatGPT envoie une fois rempli le formulaire qu’il affiche, chaque champ étant écrit sous la forme {placeholder}number
Position de la suggestion dans la liste du fournisseur
array
Types d’intention, comme
COMPARISON ou HOW_TO ; vide tant que la question n’est pas classéeboolean
Indique si la même question est déjà un prompt suivi
object
Prompt source, avec
id et textobject
Réponse source, avec
id, modelId brut, providerId et createdAtstring
Date d’enregistrement de la question de suivi (horodatage ISO 8601)
Exemple de requête
curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/follow-ups?period=30&limit=1" \
-H "Authorization: Bearer qw-api-your-token-here"
Exemple de réponse
{
"success": true,
"pagination": {
"total": 38,
"count": 1,
"limit": 1,
"offset": 0,
"hasMore": true
},
"followUps": [
{
"id": "followup_01",
"text": "How do warehouse exports compare across analytics platforms?",
"kind": "SUGGESTION",
"position": 1,
"types": ["COMPARISON"],
"isMonitored": false,
"question": {
"id": "prompt_01",
"text": "Which analytics platforms support warehouse exports?"
},
"answer": {
"id": "answer_01",
"modelId": "openai-chatgpt-core",
"providerId": "openai",
"createdAt": "2026-07-19T10:00:00.000Z"
},
"createdAt": "2026-07-19T10:00:02.000Z"
}
]
}
Erreurs
| Statut | Code | Description |
|---|---|---|
| 400 | INVALID_PARAMETER | Valeur de filtre ou de pagination invalide |
| 401 | erreur de passerelle | Échec de l’authentification |
| 404 | BRAND_NOT_FOUND | Marque inexistante ou inaccessible |
| 429 | erreur de passerelle | Limite de débit dépassée ; respectez Retry-After |

