DOCS

List competitors

GET/v1/competitors

The competitors tracked for a brand, with their visibility over the last 30 days.

Read-onlyAll plans

Query parameters

brand_idstringoptionalThe brand to read. Optional when your key covers one brand; required for agency keys and when trying the API signed in.

Response

A list of competitor objects.

objectstringAlways list.
dataarray of objectsThe items.
idstringCompetitor id, cmp_….
namestringName.
domainstring or nullWebsite.
visibilitynumberVisibility over the last 30 days, 0 to 100.
has_morebooleanWhether there is another page.
next_cursorstring or nullPass as cursor to get the next page.

Errors

401unauthorizedMissing or revoked API key.
404not_foundNo brand with that id that this key can read.
429rate_limitedToo many requests; see Retry-After.