Skip to main content
GET
/
v1
/
reports
/
brand
/
{reportId}
/
citations
/
stats
Get citation statistics for a brand report
curl --request GET \
  --url https://data.otterly.ai/v1/reports/brand/{reportId}/citations/stats \
  --header 'Authorization: Bearer <token>'
{
  "domainRank": {
    "citations": [
      {
        "domain": "adidas.com",
        "rank": 1,
        "citations": 42,
        "logoUrl": "https://logo.clearbit.com/adidas.com",
        "citationShare": 0.42,
        "main": true
      }
    ]
  },
  "domainCitations": {
    "current": 42,
    "total": 100,
    "citationShare": 0.42,
    "mostCitedUrls": [
      {
        "url": "https://www.adidas.com/us/running",
        "rank": 1,
        "currentCitations": 18,
        "citationShare": 0.42
      }
    ]
  },
  "citations": [
    {
      "url": "https://www.adidas.com/us/running",
      "rank": 1,
      "currentCitations": 18,
      "logoUrl": "https://logo.clearbit.com/adidas.com",
      "citationShare": 0.42
    }
  ],
  "competitors": [
    {
      "brandDomain": "nike.com",
      "domainCitations": {
        "current": 12,
        "total": 100,
        "citationShare": 0.12
      }
    }
  ]
}

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 stats window (inclusive).

Minimum string length: 1
Example:

"2025-01-01"

endDate
string
required

End date for the stats window (inclusive).

Minimum string length: 1
Example:

"2025-01-31"

country
string
required

Country code to filter 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 stats by tag id.

domainLimit
integer

Optional. Cap on number of distinct domains aggregated into the response. Positive integer.

Example:

10

Response

Citation statistics for the brand report.

domainRank
object
required
domainCitations
object
required
citations
object[]
required
competitors
object[]
required