Skip to main content
GET
/
api
/
research
/
track
/
stats
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/track/stats
{
  "status": "success",
  "result": "success",
  "message": "Data Retrieved.",
  "stats": [
    {
      "source": "<string>",
      "data": {
        "streams_total": 84213771,
        "popularity_current": 64,
        "playlists_current": 1200,
        "playlists_total": 4830,
        "playlist_reach_current": 18450201,
        "playlist_reach_total": 51200988,
        "charts_current": 3,
        "charts_total": 41,
        "shazams_total": 220145,
        "charted_cities_total": 87,
        "charted_countries_total": 23,
        "favorites_total": 0,
        "reposts_total": 0,
        "engagement_rate_total": 0,
        "playlists_editorial_current": 12,
        "playlists_editorial_total": 58
      },
      "data_source": "apify_spotify_playcount",
      "captured_at": "2023-11-07T05:31:56Z"
    }
  ],
  "track_info": {
    "songstats_track_id": "<string>",
    "title": "<string>",
    "avatar": "<string>",
    "site_url": "<string>",
    "release_date": "<string>",
    "artists": [
      {
        "name": "<string>"
      }
    ],
    "is_remix": true,
    "collaborators": [
      {
        "name": "<string>",
        "roles": [
          "<string>"
        ]
      }
    ],
    "labels": [
      {}
    ],
    "distributors": [
      {
        "name": "<string>"
      }
    ],
    "genres": [
      "<string>"
    ],
    "links": [
      {
        "source": "<string>",
        "external_id": "<string>",
        "url": "<string>",
        "isrc": "<string>"
      }
    ]
  },
  "source_ids": [
    "<string>"
  ]
}

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.