Skip to main content
GET
/
api
/
spotify
/
search
cURL
curl --request GET \
  --url https://api.recoupable.com/api/spotify/search \
  --header 'Authorization: Bearer <token>'
{
  "artists": {
    "href": "<string>",
    "items": [
      {
        "external_urls": {
          "spotify": "<string>"
        },
        "followers": {
          "href": "<string>",
          "total": 123
        },
        "genres": [
          "<string>"
        ],
        "href": "<string>",
        "id": "<string>",
        "images": [
          {
            "url": "<string>",
            "height": 123,
            "width": 123
          }
        ],
        "name": "<string>",
        "popularity": 123,
        "type": "artist",
        "uri": "<string>"
      }
    ],
    "limit": 123,
    "next": "<string>",
    "offset": 123,
    "previous": "<string>",
    "total": 123
  },
  "albums": {},
  "tracks": {},
  "playlists": {}
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q
string
required

The search query keywords and optional field filters

type
string
required

A comma-separated list of item types to search across: album, artist, playlist, track, show, episode, audiobook

market
string

An ISO 3166-1 alpha-2 country code or 'from_token'

limit
integer
default:20

Maximum number of results to return (default: 20, min: 1, max: 50)

Required range: 1 <= x <= 50
offset
integer
default:0

The index of the first result to return (default: 0, max: 10000)

Required range: x <= 10000

Response

Search results retrieved successfully

artists
object

Search results for artists (if type includes artist)

albums
object

Search results for albums (if type includes album)

tracks
object

Search results for tracks (if type includes track)

playlists
object

Search results for playlists (if type includes playlist)