Skip to main content
GET
/
api
/
research
/
playlists
cURL
curl --request GET \
  --url https://api.recoupable.dev/api/research/playlists
{
  "status": "success",
  "placements": [
    {
      "playlist_id": "<string>",
      "playlist_name": "<string>",
      "external_url": "<string>",
      "followers_total": "<string>",
      "image_url": "<string>"
    }
  ]
}

Query Parameters

​
artist
string

Artist name. Required unless id is provided.

​
platform
enum<string>
default:spotify
Available options:
spotify,
applemusic,
deezer,
amazon,
youtube
​
status
enum<string>
default:current
Available options:
current,
past
​
limit
integer
default:20
​
id
string

Provider artist ID returned by lookup or search. Required unless artist is provided.

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
Example:

"artist_123"

Response

Playlist placements

​
status
enum<string>
Available options:
success,
error
Example:

"success"

​
placements
object[]