v1
latestOpenAPI 3.0.32026-07-226744340.8 KBShare of Voice
An entity's share of press attention against a peer denominator over a window, with a plot-ready timeline. Plan-gated (can_use_share_of_voice; admins always).
Query parameters
Canonical entity id / wikipedia_url.
Resolve by name.
Denominator category (CAMEO+ domain/subcategory). Full list: Taxonomy & Codes.
Primary free-text denominator — a literal story-label match that defines the media space the entity's share of voice is measured against. At least one denominator-defining filter (topic, query, category, country, region, languages, or source_set) is required, else the request returns 400 DENOMINATOR_REQUIRED.
Semantic (embedding-based) denominator — an opt-in, slower alternative to topic that defines the media space by similarity rather than a literal label; sets denominator.search_mode = semantic in the response.
Restrict the denominator (and numerator) to stories with coverage in these source languages — comma-separated ISO codes such as ar,zh,en; alias language accepted. Also usable as a denominator-defining filter on its own.
Window start YYYY-MM-DD (≤30-day window).
Window end YYYY-MM-DD.
Trailing N-day window (1–30).
Max rows.
Response
Share of Voice.