Obtenir un Topic
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}"
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}/keywords/{keywordId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Topics
Obtenir un Topic
Lisez les champs modifiables d’un Topic, y compris un Topic sans réponse, et l’ETag nécessaire pour le mettre à jour ou le supprimer avec l’en-tête If-Match.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
keywords
/
{keywordId}
Obtenir un Topic
curl --request GET \
--url https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId} \
--header 'Authorization: <authorization>'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/keywords/{keywordId}"
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}/keywords/{keywordId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Renvoie la configuration du Topic, y compris les libellés sans réponse. La lecture est disponible à partir de Growth et Agency Growth.
Réponse
Renvoie200, l’ETag de la ressource et Cache-Control: private, no-store. L’objet topic contient id, text, version, createdAt et updatedAt. Les dates sont des chaînes ISO 8601. Copiez l’ETag dans If-Match pour une mise à jour ou une suppression.
Requête et réponse synthétiques
curl -i "https://www.qwairy.co/api/v1/brands/$BRAND_ID/keywords/$TOPIC_ID" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN"
{
"success": true,
"topic": {
"id": "11111111-0000-4000-8000-000000000000",
"text": "Pricing",
"version": 4,
"createdAt": "2026-09-01T09:00:00.000Z",
"updatedAt": "2026-09-01T10:00:00.000Z"
}
}
Erreurs
Un workspace inaccessible renvoie404 BRAND_NOT_FOUND ; un Topic absent renvoie 404 KEYWORD_NOT_FOUND. Une ressource d’une autre équipe ne se distingue pas d’une ressource absente. Consultez Codes d’erreur et respectez Retry-After sur 429.
