v1
latestOpenAPI 3.0.32026-07-226744340.8 KBEntities
Entity tone (by entity)
Media tone toward a specific entity over a date window, with optional cited evidence. Requires a plan with Entity media tone access (can_use_tone) — the Analyst, Media Intelligence, Geopolitical Intelligence, and Global Intelligence plans.
get/api/v2/entities/{entity_id}/tone
Path parameters
entity_idstring required
Canonical entity id or wikipedia_url.
Query parameters
date_startstring
Window start YYYY-MM-DD (≤30-day window).
date_endstring
Window end YYYY-MM-DD.
daysinteger
Trailing N-day window (1–30).
languagesstring
Comma-separated language filter (e.g. en,zh). Accepted codes: Taxonomy & Codes — Languages.
include_evidenceboolean
Return cited evidence snippets.
limitinteger
Max rows.
bucket'day' | 'week' | 'month'
Time bucket for the tone series. See Taxonomy & Codes — Media Intelligence.
quality'production_ready' | 'reviewable' | 'all'
Evidence-gating quality tier for which tone rows to return.
min_confidencenumber
Minimum per-bucket tone confidence to include (0–1).
Response
Entity tone (by entity).