Skip to main content
GET
/
api
/
research
/
playlist
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research/playlist
{
  "status": "<string>",
  "id": 123,
  "name": "<string>",
  "description": "<string>",
  "image_url": "<string>",
  "playlist_id": "<string>",
  "owner_name": "<string>",
  "owner_id": 123,
  "user_id": "<string>",
  "followers": 123,
  "num_track": 123,
  "editorial": true,
  "personalized": true,
  "code2": "<string>",
  "catalog": "<string>",
  "active_ratio": 123,
  "suspicion_score": 123,
  "fdiff_week": 123,
  "fdiff_month": 123,
  "last_updated": "<string>",
  "sys_last_updated": "<string>",
  "genres": [
    {}
  ],
  "moods": [
    {}
  ],
  "activities": [
    {}
  ],
  "mood_smart_ordered": [
    {}
  ],
  "activity_smart_ordered": [
    {}
  ],
  "tags": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

platform
enum<string>
required

Streaming platform the Chartmetric playlist is sourced from.

Available options:
spotify,
applemusic,
deezer,
amazon,
youtube
id
string
required

Chartmetric playlist ID (positive integer). This is not the streaming platform's native ID — e.g. Spotify's base62 ID 37i9dQZF1DXcBWIGoYBM5M for RapCaviar maps to Chartmetric ID 848051. Obtain via GET /api/research with type=playlists&beta=true.

Pattern: ^[1-9][0-9]*$
Example:

"848051"

Response

Playlist metadata

Playlist metadata — name, description, follower count, track count, curator info, and Chartmetric-derived signals (editorial flag, suspicion score, active-ratio, week/month delta, mood/activity/genre tags).

status
string
id
integer

Chartmetric playlist ID (same as the id query param).

name
string
description
string | null
image_url
string | null
playlist_id
string

Platform-native playlist ID (e.g. Spotify base62).

owner_name
string | null

Curator display name (what used to be advertised as curator_name).

owner_id
integer | null
user_id
string | null
followers
integer | null
num_track
integer

Track count on the playlist (note: field is num_track, not num_tracks).

editorial
boolean

True if this is a first-party editorial playlist (e.g. Spotify's RapCaviar).

personalized
boolean
code2
string | null

ISO-3166 alpha-2 country code associated with the playlist, when known.

catalog
string | null
active_ratio
integer

Fraction of days recently that the playlist was updated (Chartmetric-internal).

suspicion_score
integer

Chartmetric's internal playlist-suspicion score (lower is better).

fdiff_week
integer

Follower change over the last week.

fdiff_month
integer

Follower change over the last month.

last_updated
string

ISO timestamp the playlist was last modified upstream.

sys_last_updated
string

ISO timestamp Chartmetric last synced the playlist.

genres
object[]
moods
object[]
activities
object[]
mood_smart_ordered
object[]
activity_smart_ordered
object[]
tags
object[]