Skip to main content
GET
Tracked competitors over time

Authorizations

Authorization
string
header
required

Your API key, e.g. Authorization: Bearer gp_live_....

Path Parameters

id
string<uuid>
required

Brand id.

Query Parameters

engine
enum<string>

Restrict to one engine. Omit for the all-engine rollup. Stable public engine identifier. Internal model names are never exposed.

Available options:
chatgpt,
claude,
perplexity,
gemini,
google_ai_overviews,
google_ai_mode,
copilot
from
string<date>

Inclusive start date. Defaults to 30 days before to.

to
string<date>

Exclusive end date. Defaults to tomorrow.

granularity
enum<string>
default:day

Bucket size.

Available options:
day,
week
competitor_id
string<uuid>[]

Repeatable. Return only these tracked competitors (plus the brand). Ids from /tracked-competitors, or competitor_id on /competitors rows.

topic_id
string<uuid>[]

Repeatable. Restrict to prompts in these topics. Cannot be combined with prompt_id.

prompt_id
string<uuid>

Restrict to one prompt this brand tracks: who beats you on that question.

branding
enum<string>
default:all

Restrict to prompts that name this brand (branded) or to those that do not (non_branded). Omit, or all, for every prompt.

Available options:
all,
branded,
non_branded
compare
boolean
default:false

Adds previous and changes to the brand and each competitor, for the same-length window before this one.

Response

Success

data
object
required
Example: