Skip to main content
GET
One tracked competitor in detail

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string<uuid>
required

Brand id.

competitorId
string<uuid>
required

Tracked competitor 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.

breakdown
enum<string>
default:engine

Which dimension to break the window down by.

Available options:
engine,
topic,
prompt
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

Response

Success

data
object
required
Example: