Skip to main content
GET
Visibility Over Time

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

brands
string<uuid>[]
required

Brand UUIDs. Pass repeated brands[]=... query params.

Required array length: 1 - 10 elements
start_date
string<date>

YYYY-MM-DD. Required when end_date is provided.

end_date
string<date>

YYYY-MM-DD. Required when start_date is provided; must be on or after start_date. Capped at the project's latest available date.

tags
string[]

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

topics
string[]

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

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.

aggregation
enum<string>

Bucket granularity. Defaults to daily.

Available options:
daily,
weekly,
monthly

Response

An array of brand series. One entry per requested brand, preserving input order.

brand
string<uuid>
required

Brand UUID.

brand_name
string
required
data
object[]
required