Docs Sign inGet started
API reference · Metrics

Get competitors

Benchmark of tracked brands, plus untracked brands named.

Ask Claude Ask ChatGPT
GET/api/v1/domains/{domain}/competitors

Path parameters

domainstringRequired

The domain's host, like acme.example, or its ID. List them with List domains.

Query parameters

rangestringdefault 30d

How far back to count: 7d, 30d, 90d or all. The previous period is the same length, just before.

7d30d90dall
surfacestring

Limit to one surface, written engine:lane, e.g. chatgpt_app:chat.

topicstring

Limit to prompts in one topic (exact name).

brandedstringdefault unbranded

Whether to count prompts that name your brand: unbranded (default), all or branded.

unbrandedallbranded

Returns

brandsarray

You and every tracked competitor, by visibility.

brands[].visibilityrate object

How often answers name this brand.

brands[].changechange object or null

Compared with the previous period.

brands[].sovnumber

Share of voice, 0 to 1.

brands[].positionnumber or null

Average rank when named.

brands[].sparkarray

Visibility per run date, for a sparkline.

untrackedarray

Up to 15 brands answers named that you don't track, as {name, answers}.

Every response includes the domain and the filters that were applied. Errors use the standard error object.