Brand Rankings
Returns paginated brand rankings within a date range, with optional filters for brands, tags, services, countries, prompts, topics, and brand search. Use brands with only_brand or always_include_brand to pin a specific brand.
Authorizations
Team API key created in Team Settings. Use it with URLs for the same team.
Path Parameters
Project UUID.
Query Parameters
Inclusive start of the reporting window. YYYY-MM-DD.
Inclusive end of the reporting window. YYYY-MM-DD. Must be on or after start_date.
x >= 11 <= x <= 100Brand UUID filter. Pass a single brand UUID as brands[]=....
1Tag UUID filters. Discover tag UUIDs with GET /api/v1/projects/{project}/tags.
AI platform provider filters such as chatgpt or perplexity. Discover providers with GET /api/v1/platforms.
Country code filters such as US or GB. Discover codes with GET /api/v1/countries.
Prompt UUID filter.
Topic UUID filters. Use no_topic for prompts without a topic. Discover topic UUIDs with GET /api/v1/projects/{project}/topics.
255When true, only the primary brand and marked competitors are included.
When true and brands contains one brand UUID, only that brand's ranking is returned.
When true and brands contains one brand UUID, the pinned brand is always included in the paginated result even if it would not otherwise appear on the current page.