Skip to main content
GET
/
api
/
v1
/
brands
/
{brandId}
/
perception
/
{snapshotId}
Get Perception Snapshot
curl --request GET \
  --url https://api.example.com/api/v1/brands/{brandId}/perception/{snapshotId} \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "brand": {},
  "snapshot": {
    "snapshotId": "<string>",
    "month": 123,
    "year": 123,
    "scores": {},
    "attributes": [
      {}
    ],
    "attributeMetrics": {},
    "insights": {},
    "providers": [
      {}
    ],
    "createdAt": "<string>",
    "completedAt": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt

Use this file to discover all available pages before exploring further.

Retrieve the full detail of a single completed perception snapshot: the four scores, the attribute alignment breakdown and the SWOT insights. Get a snapshotId from the Brand Perception endpoint’s history array.
​
Authorization
string
required
Bearer token. Example: Bearer qw-api-xxx

​
Path Parameters

​
brandId
string
required
The unique identifier of the brand
​
snapshotId
string
required
The unique identifier of the perception snapshot

​
Response

​
success
boolean
Indicates if the request was successful
​
brand
object
id, name, domain
​
snapshot
object
A 404 RESOURCE_NOT_FOUND is returned if the snapshot does not exist, is not COMPLETED, or does not belong to the brand.

​
Example Request

curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/perception/snap_2026_05" \
  -H "Authorization: Bearer qw-api-your-token-here"

​
Example Response

{
  "success": true,
  "brand": {
    "id": "cm1234567890abcdef",
    "name": "My Brand",
    "domain": "mybrand.com"
  },
  "snapshot": {
    "snapshotId": "snap_2026_05",
    "month": 5,
    "year": 2026,
    "scores": {
      "sentiment": 78,
      "alignment": 65,
      "consistency": 82,
      "factualAlignment": 71
    },
    "attributes": [
      { "text": "Premium positioning", "status": "aligned" },
      { "text": "Sustainable materials", "status": "partial" },
      { "text": "Made in France", "status": "missing" }
    ],
    "attributeMetrics": {
      "aligned": 1,
      "partial": 1,
      "missing": 1,
      "total": 3
    },
    "insights": {
      "strengths": ["Strong brand recognition in core market"],
      "weaknesses": ["Limited awareness of product range"],
      "opportunities": ["Growing demand in adjacent category"],
      "threats": ["Aggressive competitor messaging"]
    },
    "providers": ["chatgpt", "perplexity"],
    "createdAt": "2026-05-01T03:00:00.000Z",
    "completedAt": "2026-05-03T04:12:00.000Z"
  }
}