Skip to main content
GET
Get Competitor Seo Trend

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

Response

Successful Response

series
CompetitorSeoTrafficSeries · object[]
required
market
SeoMarketDescriptor · object
required

WHICH market an organic-search series describes.

Organic rank, traffic and keyword counts are measured per (location_code, language_code): the same domain measured in the US and in the UK produces two unrelated numbers. Every SEO reader here is scoped to exactly one market (see get_traffic_series / get_historical_traffic_series / get_domain_seo_measurement), and a brand can change its market at any time from the market modal — so a series that does not NAME its market silently changes basis under the reader, who has no way to tell that the axis moved.

Carried alongside basis and for the same reason: state what was measured rather than render a plausible number. basis names WHOSE acquisition paid; this names WHAT MARKET it bought.

country_code / country_name are null for a location_code outside brand_market_service.MARKET_COUNTRIES — a market can be persisted (or configured as the fallback default) without appearing in the picker's catalogue. label is always populated and always renderable: it degrades to the bare code rather than to an empty string, because the whole point of this object is that the reader is never left guessing.

ai_share_of_voice_state
enum<string>
required
Available options:
measured,
pending_first_capture,
not_eligible_unregistered,
not_eligible_no_industry,
not_eligible_no_competitors,
capture_disabled,
capture_unavailable
ai_share_of_voice
CompetitorAiSovCapture · object | null
estimate_notice
string
default:""