Skip to main content
GET
/
api
/
research
/
track
/
playlists
cURL
curl --request GET \
  --url https://recoup-api.vercel.app/api/research/track/playlists
{
  "status": "success",
  "placements": [
    {}
  ]
}

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

id
string

Chartmetric track ID. Required if q is not provided. Obtain via GET /api/research with type=tracks&beta=true.

q
string

Track name to look up. Required if id is not provided. Combine with artist to narrow the match.

artist
string

Artist name to disambiguate the track lookup when using q.

platform
enum<string>
default:spotify

Streaming platform to return playlists for. Defaults to spotify.

Available options:
spotify,
applemusic,
deezer,
amazon
status
enum<string>
default:current

Return current or past playlist placements. Defaults to current.

Available options:
current,
past
limit
integer

Maximum number of placements to return.

offset
integer

Pagination offset.

since
string<date>

ISO date lower bound for placements.

until
string<date>

ISO date upper bound for placements.

sort
string

Sort column.

editorial
boolean

Include editorial playlists. When no filter flags are set, defaults to true along with indie, majorCurator, popularIndie.

indie
boolean

Include indie playlists.

majorCurator
boolean

Include major-curator playlists.

Include popular indie playlists.

personalized
boolean

Include personalized playlists.

chart
boolean

Include chart playlists.

newMusicFriday
boolean

Include New Music Friday playlists.

thisIs
boolean

Include "This Is" artist playlists.

radio
boolean

Include algorithmic radio playlists.

brand
boolean

Include brand playlists.

Response

Playlist placements for the track.

status
enum<string>
required
Available options:
success
Example:

"success"

placements
object[]
required

Playlist placement objects returned by Chartmetric (shape varies per platform).