Skip to main content
GET
/
v1
/
reports
/
brand
List brand reports
curl --request GET \
  --url https://data.otterly.ai/v1/reports/brand \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "01HXBR1DGM5XY8Z2N3KQ7VAW4P",
      "workspaceId": "01HX7K2YV9D3M8N0G6Q5R4S3T2",
      "brand": "Adidas",
      "brandVariations": [
        "adidas",
        "Adidas AG"
      ],
      "brandDomain": "adidas.com",
      "brandDomainVariations": [
        "adidas.de",
        "adidas.co.uk"
      ],
      "brandDomainWildcard": false,
      "countries": [
        "us",
        "de",
        "uk"
      ],
      "competitors": [
        {
          "brand": "Nike",
          "brandVariations": [
            "nike",
            "Nike Inc."
          ],
          "brandDomain": "nike.com",
          "brandDomainVariations": [
            "nike.de",
            "nike.co.uk"
          ],
          "brandDomainWildcard": false
        }
      ],
      "reportTitle": "Adidas Visibility Report",
      "createdDate": "2024-11-01T12:00:00.000Z",
      "updatedDate": "2025-05-01T08:30:00.000Z"
    }
  ],
  "paging": {
    "nextCursor": null,
    "hasMore": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.otterly.ai/llms.txt

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

Authorizations

​
Authorization
string
header
required

Provide your API key as a Bearer token: Authorization: Bearer YOUR_API_KEY.

Query Parameters

​
cursor
string

Optional. Pagination cursor — pass back the nextCursor value from a previous response. Omit to fetch the first page.

Minimum string length: 1
​
workspaceId
string

Optional. Filter results to a specific workspace the API key has access to. If omitted, results span every workspace the API key can read.

Minimum string length: 1
Example:

"01HX7K2YV9D3M8N0G6Q5R4S3T2"

Response

A list of brand reports.

​
items
object[]
required
​
paging
object
required
Example:
{ "nextCursor": null, "hasMore": false }