Skip to main content
GET
Get Competitor Ad 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

Months × ads projection of stored snapshots (no provider calls).

months is the contiguous calendar range over the bounded stored snapshot window for the brand's current location/language cohort. Inspect month_snapshot_counts before treating an empty month as a stored-snapshot absence: a zero count means that month has no snapshot.

competitor_domain
string
required
months
string[]
required
ads
AdHistoryEntry · object[]
required
month_snapshot_counts
Month Snapshot Counts · object
required
snapshot_count
integer
default:0
estimate_notice
string
default:Estimated — modelled from competitor paid keywords (DataForSEO). Not actual competitor spend.