Obtenir une génération de suggestions
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs/{suggestionRunId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs/{suggestionRunId}"
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}/prompt-suggestions/runs/{suggestionRunId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"status": "<string>",
"source": "<string>",
"keywordId": {},
"recommendations": {},
"createdAt": "<string>",
"completedAt": {}
}Suggestions de prompts
Obtenir une génération de suggestions
Lisez le statut d’une génération de Prompt Studio : en attente, en cours, terminée ou échouée, avec le nombre de recommandations une fois qu’elle est finie.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompt-suggestions
/
runs
/
{suggestionRunId}
Obtenir une génération de suggestions
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs/{suggestionRunId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs/{suggestionRunId}"
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}/prompt-suggestions/runs/{suggestionRunId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"status": "<string>",
"source": "<string>",
"keywordId": {},
"recommendations": {},
"createdAt": "<string>",
"completedAt": {}
}Renvoie le statut d’une génération. C’est la ressource identifiée par l’en-tête
Les erreurs de lecture utilisent les formes plate ou imbriquée décrites dans Codes d’erreur. Sur
Location de Générer des suggestions de prompts. Lorsqu’elle est COMPLETED, lisez les suggestions avec Obtenir les suggestions de prompts.
Disponible avec les offres Growth, Agency Growth, Business, Agency Business et Enterprise. Consultez Authentification.
Réponse
Requête et réponse synthétiques
curl "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompt-suggestions/runs/$SUGGESTION_RUN_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"id": "bbbbbbbb-0000-4000-8000-000000000000",
"status": "COMPLETED",
"source": "manual",
"keywordId": null,
"recommendations": 20,
"createdAt": "2026-10-12T09:00:00.000Z",
"completedAt": "2026-10-12T09:02:00.000Z"
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
401 | Corps plat | Jeton absent ou invalide |
403 | INSUFFICIENT_PLAN | Refus d’offre générique : "This endpoint is not included in the team's plan." |
404 | RESOURCE_NOT_FOUND | Le workspace ou la génération est absent ou inaccessible |
429, respectez Retry-After.
