Get a 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
Get a topic
Read a topic’s editable fields, including topics with no answers yet, and the ETag you need to update or delete it with the If-Match header.
GET
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
keywords
/
{keywordId}
Get a 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));Returns the topic configuration, including labels with no answers. Read
access is available from Growth and Agency Growth.
Response
Returns200, the resource ETag, and Cache-Control: private, no-store.
The topic object contains id, text,
version, createdAt and updatedAt. Dates are ISO 8601 strings.
Copy the ETag into If-Match for an update
or deletion.
Synthetic request and response
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"
}
}
Errors
An inaccessible workspace returns404 BRAND_NOT_FOUND; a missing topic
returns 404 KEYWORD_NOT_FOUND. A resource in another team
is indistinguishable from a missing resource. See Error codes
and honor Retry-After on 429.
