Tracks

Get Track Current Stats

Returns summary and detailed 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/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 *

with_linksboolean

Example:true

Includes an array of all of the source links associated with the requested objected.

with_playlistsboolean

Example:true

Includes an array of all of the playlists associated to the track.

with_chartsboolean

Example:true

Includes an array of all of the charts associated to the track.

with_videosboolean

Example:true

Includes an array of all of the videos currently associated to the track.

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 *

with_stationsboolean

Example:true

Includes an array of all of the radio stations currently associated to the track.

with_radio_playsboolean

Example:true

Includes the individual radio play timestamps for each returned station. Requires source=radio and with_stations=true. Use only when raw play occurrences are needed; aggregate radio totals and station summaries do not require it.

sort'greatest' | 'latest'

Example:latest

Controls ordering of expanded track-stat lists. greatest (default) preserves each source's existing ranking. latest sorts newest-first by added_at for playlists/charts, release_date for DJ charts, upload date for videos/Shorts/Reels, reposted_at for SoundCloud reposters, record_date for tracklists, and last_played_at for radio stations. Playlist/chart added_at is the earliest recorded addition in the returned aggregate, not the last position update. Missing dates sort last with stable ID tie-breakers. Sorting precedes existing pagination; expansion flags, only_current, response fields, and the maximum limit of 100 are unchanged. Does not reorder source or metadata arrays, or nested radio_plays timestamps.

limitinteger

Example:20

Specifies the limit of results being returned.

offsetinteger

Example:20

Specifies the offset of the limited results being returned.

apple_music_track_idinteger

Example:1567644047

The Apple Music ID of the track being requested *

only_currentboolean

Example:true

Only return the playlists and charts the track is currently positioned in.

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.