Skip to main content
GET
cURL

Query Parameters

artist
string

Artist name; Recoup resolves the first provider search match. Required unless id is supplied. Recoup artist UUID resolution is not implemented here.

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

current uses current placements; past uses all-time scope total, which may include current placements.

Available options:
current,
past
limit
string

Optional raw string; no Recoup default. For similar artists, only a positive integer limits the returned list; for playlists it passes through to the provider.

id
string

Research artist ID returned by search or lookup; treat it as an opaque string. Required unless artist is supplied; takes precedence when both are provided. This is not a Recoup artist/account ID.

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[]