Skip to main content
GET
/
v1
/
reports
/
brand
/
{reportId}
/
citations
List citations for a brand report
curl --request GET \
  --url https://data.otterly.ai/v1/reports/brand/{reportId}/citations \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "url": "https://www.adidas.com/us/running",
      "domain": "adidas.com",
      "title": "Adidas Running Shoes & Apparel",
      "citations": 7469,
      "prompts": [
        {
          "id": "01HXP1DRTM5G8Z2N3KQ7VAW4PA",
          "brandMentioned": 1,
          "engines": [
            "chatgpt",
            "gemini"
          ]
        }
      ],
      "isMyBrandDomain": true,
      "competitors": [
        {
          "brand": "Nike"
        },
        {
          "brand": "Asics"
        },
        {
          "brand": "New Balance"
        }
      ],
      "brandMentioned": 1,
      "domainCategory": "Brand"
    }
  ],
  "paging": {
    "limit": 25,
    "offset": 0
  }
}

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.

Path Parameters

​
reportId
string
required

Brand report identifier.

Minimum string length: 1
Example:

"01HX7K2YV9D3M8N0G6Q5R4S3T2"

Query Parameters

​
startDate
string
required

Start date for the citations window (inclusive).

Minimum string length: 1
Example:

"2025-01-01"

​
endDate
string
required

End date for the citations window (inclusive).

Minimum string length: 1
Example:

"2025-01-31"

​
country
string
required

Country code to filter citations by. Lowercase ISO 3166-1 alpha-2; use uk for the United Kingdom.

Minimum string length: 1
Example:

"us"

​
engines

Optional. AI engine(s) to filter by. Repeat the param or pass a single value.

Available options:
chatgpt,
google,
perplexity,
copilot,
google_ai_mode,
gemini
Example:

"chatgpt"

​
tagId
string

Optional. Filter citations by tag id.

​
domains

Optional. Filter citations to specific domains.

​
search
string

Optional. Free-text search.

​
offset
integer

Optional. Zero-based offset for pagination.

​
limit
integer

Optional. Maximum number of items to return.

​
sortBy
string

Optional. Field to sort by.

​
sortOrder
enum<string>

Optional. Sort direction.

Available options:
asc,
desc
​
brandMentioned
boolean

Optional. Filter citations where the brand is mentioned.

​
competitors

Optional. Filter by one or more competitor brand names.

​
domainCategories

Optional. Domain category/categories to filter by. Repeat the param or pass a single value.

Available options:
Social Media,
Community/Forum,
Brand,
Encyclopedia,
News/Media,
Blogs/Personal Sites,
Government/NGO,
Education,
Video,
Competitor,
Others,
Unclassified
Example:

"News/Media"

Response

A page of citations for the brand report.

​
items
object[]
required
​
paging
object
required
Example:
{ "limit": 25, "offset": 0 }