Tracks

Get Track Historic Stats

Returns historic information of a track filtered by source.

NOTE: For Artist/Label API Keys, please make sure to always include either the songstats_artist_id or spotify_artist_id parameter.

get/tracks/historic_stats

Query parameters

sourcestring required

Example:spotify,apple_music,deezer

Specifies the sources that data is being requested for. Can be a comma separated list of individual sources or be set to 'all'.

isrcstring

Example:GBAYE2100626

The ISRC of the track being requested *

songstats_track_idstring

Example:k4bp9etx

The Songstats ID of the track being requested *

spotify_track_idstring

Example:1YLGtZjDKyY0Qkv4QlX31b

The Spotify ID of the track being requested *

start_datestring date

Example:2021-12-31

Specifies the start_date of the historic data that is being requested.

end_datestring date

Example:2022-01-16

Specifies the end_date of the historic data that is being requested.

with_aggregatesboolean

Example:true

Includes data points aggregated by Songstats like playlists_current, playlists_reach_current, charts_current, etc.

spotify_artist_idstring

Example:28j8lBWDdDSHSSt5oPlsX2

The Spotify ID of the artist being requested *

apple_music_artist_idinteger

Example:261545033

The Apple Music ID of the artist being requested *

songstats_artist_idstring

Example:pod5zlug

The Songstats ID of the artist being requested *

apple_music_track_idinteger

Example:1567644047

The Apple Music ID of the track being requested *

Headers

Accept-Encodingstring

Example:gzip, deflate, br

gzip, deflate, br

Response

OK: The request has succeeded. The client can read the result of the response.

resultstring

messagestring

source_idsstring

Changes

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