Brand Reports

Get statistics for a brand report

Changed on
get/v1/reports/brand/{reportId}/stats

Request

  • Base URL
    https://data.otterly.ai
  • Auth
    HTTP bearer

Path parameters

reportIdstring required

Brand report identifier.

Example:01HX7K2YV9D3M8N0G6Q5R4S3T2

Query parameters

startDatestring required

Start date for the stats window (inclusive).

Example:2025-01-01
endDatestring required

End date for the stats window (inclusive).

Example:2025-01-31
countrystring required

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

Example:us
frequency'daily' | 'weekly'

Optional. weekly buckets the periods by ISO week (a weekly run lands on its week's Monday; the current, unfinished week is left out). Defaults to weekly for a workspace monitored weekly, otherwise daily.

Example:weekly
'chatgpt' | 'google' | 'perplexity' | 'copilot' | 'google_ai_mode' | 'gemini' | 'claude'

AI engine identifier.

OR
string[]
Example:chatgpt
tagIdstring

Optional. Filter stats by tag id.

Response

Statistics for the brand report.

idstring required
statusstring required
isRecalculatingboolean required
totalPromptsinteger required

Changes