v1

latestOpenAPI 3.0.32026-07-226744340.8 KB

Media Intelligence

Entity tone

Entity-conditioned media tone, risk, and confidence over a window, with cited evidence. Resolve the entity first with /api/v2/search. Requires a plan with Entity media tone access (can_use_tone) — the Analyst, Media Intelligence, Geopolitical Intelligence, and Global Intelligence plans.

get/api/v2/entity-tone

Query parameters

entity_idstring

Canonical entity id / wikipedia_url.

entity_searchstring

Resolve by name instead of id.

qstring

Alias for entity_search.

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

Language filter (e.g. en,zh,ar). Accepted codes: Taxonomy & Codes — Languages.

include_evidenceboolean

Include evidence snippets.

evidence_limitinteger

Max evidence samples returned for the window — one card per story (default 25, max 250). Applied as a single global limit over the window, not a per-bucket cap.

limitinteger

Max rows.

Response

Entity tone.

statusstring

start_datestring

end_datestring

entitiesstring[]