Skip to main content
GET
Get Competitor Seo Position History

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

brand_id
string<uuid>
required

Query Parameters

competitor
string
required

competitor domain

Minimum string length: 1

Response

Successful Response

Per-keyword position over time for ONE competitor domain.

Empty keywords with available=False is explained by unavailable_reason — NOT interpreted as "nothing moved".

competitor_domain
string
required
available
boolean
default:false
unavailable_reason
enum<string> | null
Available options:
insufficient_captures,
no_usable_ranks
captured_ats
string<date-time>[]
keywords
SeoKeywordPositionHistory · object[]
total_keywords_seen
integer
default:0
any_capture_capped
boolean
default:false
estimate_notice
string
default:""