Skip to main content
GET
/
api
/
v1
/
brands
List Brands
curl --request GET \
  --url https://api.example.com/api/v1/brands \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "total": 123,
  "brands": [
    {
      "id": "<string>",
      "name": "<string>",
      "domain": "<string>"
    }
  ]
}
Brands are the core entities in Qwairy. Each brand represents a company or product you monitor across AI platforms. This endpoint returns every brand your team can access.
See Entities for the complete Brand object structure.
​
Authorization
string
required
Bearer token. Example: Bearer qw-api-xxx

​
Response

​
success
boolean
Indicates if the request was successful
​
total
number
Total number of brands
​
brands
array

​
Example Request

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

​
Example Response

{
  "success": true,
  "total": 2,
  "brands": [
    {
      "id": "cm1234567890abcdef",
      "name": "My Brand",
      "domain": "mybrand.com"
    },
    {
      "id": "cm0987654321fedcba",
      "name": "My Other Brand",
      "domain": "myotherbrand.com"
    }
  ]
}

​
Next Steps

Once you have your brand IDs, you can: