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>"
    }
  ]
}

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.

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: