CHchartmetric
Track

Get Track Stats by Platform

Return historical stats for a track on a platform. mode selects the aggregation bucket. platform accepts chartmetric, spotify, youtube, tiktok, etc. type query param selects the stat column (e.g. streams, popularity). Wrapped in a single-element array under obj.

get/api/track/{id}/{platform}/stats/{mode}

Request

Path parameters

platform'shazam' | 'spotify' | 'youtube' | 'tiktok' | 'genius' | 'soundcloud' | 'chartmetric' | 'line' | 'melon' | 'radio' required

Streaming platform whose stats to retrieve. One of shazam, spotify, youtube, tiktok, genius, soundcloud, chartmetric, line, melon, radio.

integer required
OR
string required
OR
integer required
mode'highest-playcounts' | 'most-history' required

Selection algorithm when multiple platform tracks map to one Chartmetric track. highest-playcounts picks the most-played; most-history picks the longest-tracked.

Query parameters

sincestring date

Inclusive start of the stat date range in YYYY-MM-DD format. Defaults to 180 days before today.

'total_spins'
OR
'listen_count' | 'artist_likes'
OR
'likes_melon'
OR
'streams' | 'popularity'
OR
'score' | 'rank'
OR
'posts' | 'views' | 'comments' | 'sound_posts' | 'sound_views' | 'sound_likes' | 'sound_comments'
OR
string
untilstring date

Inclusive end of the stat date range in YYYY-MM-DD format. Defaults to today.

latestboolean

If true, return only the most recent data point regardless of since/until.

interpolatedboolean

If true, fill gaps in the time series with interpolated values to produce a smooth curve. Not applicable for Spotify.

isDomainIdboolean

If true, treat id as a platform-native ID rather than a Chartmetric track ID. Defaults to false.

extrapolated'before' | 'after' | 'both'

Extrapolation mode for projecting values outside the observed range. One of before, after, both.

Response

Success

Changes

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