Analytics

Mentions over time

Matched, relevant and sentiment counts per day or week across the window, as one total series or split per platform or per keyword with by. The window is range (7d, 30d, 90d, 365d, ending today) or from and to, cut into days in timezone (UTC by default); keywordIds and platforms narrow it; compare=true adds the period of the same length right before it. Time axis is the publish date.

get/v1/analytics/series

Request

  • Base URL: https://api.mentio.dev
  • URL: https://api.mentio.dev/v1/analytics/series
  • Auth: HTTP bearer

Query parameters

range'7d' | '30d' | '90d' | '365d'

Preset window ending today. Ignored when from or to is given. Default 30d.

fromstring

First day, YYYY-MM-DD, inclusive, in timezone.

tostring

Last day, YYYY-MM-DD, inclusive, in timezone. Default today.

keywordIdsstring[] nullable

Only these keyword ids. Repeatable, or comma-separated; omit for every keyword.

platformsstring[]

Only these platforms. Repeatable, or comma-separated; omit for every platform.

compareboolean

true adds the period of the same length right before the window as previous.

timezonestring

IANA zone the days are cut in (Europe/Madrid). Default UTC. One offset, the zone's at the end of the window, applies to the whole window.

bucket'hour' | 'day' | 'week' | 'month'

Point granularity: hour (windows of at most 14 days), day, week (Monday start) or month. Default: day up to 90 days, week beyond.

by'platform' | 'keyword' | 'sentiment'

Split into one series per platform, per keyword (the top 20 by matched, the rest folded into "other") or per sentiment (positive, neutral, negative, unclassified). Omit for one total series.

Response

Zero-filled series, oldest point first

Changes

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