Share of mentions by one dimension
Mentions grouped by dimension — source (platform), keyword, tag (AI topic label), language (ISO 639-1) or author (platform handle) — over an inclusive YYYY-MM-DD window (default: the last 30 days), with each group’s share of the distinct mentions in the window. Relevant mentions only unless includeAll=true; limit caps the rows (default 10). A mention with several keywords or tags counts once per group.
Authorizations
Clerk API key. Create one in Settings → API Keys. Pass as Authorization: Bearer <key>. Keys carry a scope — read, write (implies read) or admin (implies write) — chosen when the key is minted. Each operation's security requirement (and its x-required-scope extension) names the minimum scope it needs; request the least-privileged key that covers the operations you call.
Query Parameters
Numeric ids of the monitored keywords to scope to (from list_keywords). Omit for every keyword. A mention that matched several keywords counts once per keyword in per-keyword breakdowns and once in totals.
0 < x <= 9007199254740991Inclusive first day of the window as YYYY-MM-DD (UTC) — NEVER an ISO timestamp with T/Z. Omit for the default: the last 30 days ending today.
^\d{4}-\d{2}-\d{2}$Inclusive last day of the window as YYYY-MM-DD (UTC). Omit for today. Must be on or after startDate; the window may span at most 365 days.
^\d{4}-\d{2}-\d{2}$Count every collected mention, including the ones the AI scored Low relevance or has not scored yet. Default false: only relevant mentions (High + Medium) count — the same set the mentions feed shows by default.
What to group by: source (platform), keyword, tag (AI topic label), language (ISO 639-1) or author (platform handle).
source, keyword, tag, language, author How many rows to return, highest volume first. 1–50, default 10.
1 <= x <= 50Response
200 response
source, keyword, tag, language, author Distinct mentions in the window (a mention with several keywords / tags counts once here but once per group in data, so shares can sum to more than 100).
-9007199254740991 <= x <= 9007199254740991Sorted by count desc, capped by limit.
