Skip to main content
GET
cURL

Query Parameters

isrc
string

Track ISRC. Provide exactly one track identifier.

Example:

"USQY51771120"

songstats_track_id
string

Songstats track id (from GET /api/research/tracks).

spotify_track_id
string

Spotify track id.

apple_music_track_id
string

Apple Music track id.

source
string
required

Comma-separated list of sources, or all. e.g. spotify, apple_music, deezer, youtube.

Example:

"spotify"

with_playlists
boolean

Include the per-source playlists[] array in data.

with_charts
boolean

Include the per-source charts[] array in data.

with_stations
boolean

Include radio stations[] data where available.

with_videos
boolean

Include video data where available.

Include external links where available.

only_current
boolean

Return only current counters, omitting historical/total breakdowns where applicable.

limit
integer

Max items in toggled arrays (e.g. playlists[]).

offset
integer

Pagination offset for toggled arrays.

Response

Per-track current stats, one entry per requested source.

Per-track current statistics for the requested source(s). Mirrors ResearchMetricsResponse, scoped to a single recording. When every requested source is store-served, the response is the minimal envelope { result, stats }track_info, source_ids, and message appear only when Songstats served part of the request.

status
string
Example:

"success"

result
string
Example:

"success"

message
string
Example:

"Data Retrieved."

stats
object[]
track_info
object

Full track record.

source_ids
string[]

All source identifiers Songstats tracks for this recording — a superset of the sources returned in stats.