cURL

curl --request GET \
  --url https://api.recoupable.dev/api/research/track/playlists

const options = {method: 'GET'};

fetch('https://api.recoupable.dev/api/research/track/playlists', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recoupable.dev/api/research/track/playlists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recoupable.dev/api/research/track/playlists"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recoupable.dev/api/research/track/playlists")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "placements": [
    {}
  ]
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "error": "insufficient_credits",
  "remaining_credits": 0,
  "required_credits": 50000,
  "billingUrl": "https://app.recoupable.dev"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Request failed with status 501"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

Playlists

Track Playlists

Read available track playlist and activity entries. Supply a selected track id, or a track name q with optional artist. Name resolution selects the first Spotify match and resolves its research ID; id takes precedence. Filtering and pagination support depend on the data connection. With no filter flags, editorial, indie, majorCurator and popularIndie default to true. Track-name resolution can add separately charged lookup calls; reuse a selected ID to avoid them.

Use your Recoup API key (x-api-key) or supported bearer credential. Successful artist and track research reads cost $0.05 (50,000 micro-dollar credits). Recoup manages the data connections. Coverage and rate limits vary; see Research availability.

GET

api

research

track

playlists

cURL

curl --request GET \
  --url https://api.recoupable.dev/api/research/track/playlists

const options = {method: 'GET'};

fetch('https://api.recoupable.dev/api/research/track/playlists', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.recoupable.dev/api/research/track/playlists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.recoupable.dev/api/research/track/playlists"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.recoupable.dev/api/research/track/playlists")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "placements": [
    {}
  ]
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "error": "insufficient_credits",
  "remaining_credits": 0,
  "required_credits": 50000,
  "billingUrl": "https://app.recoupable.dev"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Request failed with status 501"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

{
  "status": "error",
  "error": "Missing required parameter: artist"
}

Query Parameters

string

Exact provider track ID; required unless q is supplied. Takes precedence over q. Recoup does not validate its format here.

Example:

"track_123"

string

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

artist

string

Optional artist name to narrow Spotify track-name matching. Ignored when id is supplied.

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

string

Maximum number of placements to return. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

offset

string

Pagination offset. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

since

string

ISO date lower bound for placements. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

until

string

ISO date upper bound for placements. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

sort

string

Sort column. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

editorial

string

Include editorial playlists. When no filter flags are set, defaults to true along with indie, majorCurator, popularIndie. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

indie

string

Include indie playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

majorCurator

string

Include major-curator playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

popularIndie

string

Include popular indie playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

personalized

string

Include personalized playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

chart

string

Include chart playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

newMusicFriday

string

Include New Music Friday playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

thisIs

string

Include "This Is" artist playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

radio

string

Include algorithmic radio playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

brand

string

Include brand playlists. Forwarded unchanged as a raw string; Recoup does not validate its range, date format or boolean value. Provider support applies.

Response

Playlist placements for the track.

status

enum<string>

required

Available options:

success

Example:

"success"

placements

object[]

required

Playlist placement objects returned by the configured provider (shape varies per platform).

Artist discovery

Metrics & insights

Catalog

Playlists

Web & social

Track Playlists

Query Parameters

Response