Entities

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).

statusstring

start_datestring

end_datestring

entitiesstring[]

Changes

No recorded changes to this endpoint across all 1 revision of this API.