Skip to main content
GET
Brand Rankings

Authorizations

Authorization
string
header
required

Team API key created in Team Settings. Use it with URLs for the same team.

Path Parameters

project
string<uuid>
required

Project UUID.

Query Parameters

start_date
string<date>
required

Inclusive start of the reporting window. YYYY-MM-DD.

end_date
string<date>
required

Inclusive end of the reporting window. YYYY-MM-DD. Must be on or after start_date.

page
integer
Required range: x >= 1
per_page
integer
default:50
Required range: 1 <= x <= 100
brands
string<uuid>[]

Brand UUID filter. Pass a single brand UUID as brands[]=....

Maximum array length: 1
tags
string[]

Tag UUID or name filters. Discover tags with GET /api/v1/projects/{project}/tags.

services
string[]

AI platform provider filters such as chatgpt or perplexity. Discover providers with GET /api/v1/platforms.

countries
string[]

Country code filters such as US or GB. Discover codes with GET /api/v1/countries.

prompt
string<uuid>

Prompt UUID filter.

topics
string[]

Topic UUID or name filters. Use no_topic for prompts without a topic. Discover topics with GET /api/v1/projects/{project}/topics.

Maximum string length: 255
competitors_only
boolean

When true, only the primary brand and marked competitors are included.

only_brand
boolean

When true and brands contains one brand UUID, only that brand's ranking is returned.

always_include_brand
boolean

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.

Response

Paginated brand rankings.

data
object[]
required
meta
object
required