Skip to main content
GET
/
api
/
v1
/
search
Search
curl --request GET \
  --url https://spotify-api31.p.rapidapi.com/api/v1/search \
  --header 'x-rapidapi-key: <api-key>'
{
  "data": [
    {
      "id": "6habFhsOp2NvshLv26DqMb",
      "name": "Despacito",
      "uri": "spotify:track:6habFhsOp2NvshLv26DqMb",
      "duration": 229360,
      "artists": [
        {
          "name": "Luis Fonsi",
          "uri": "spotify:artist:4V8Sr092TqfHkfAA5fXXqG"
        },
        {
          "name": "Daddy Yankee",
          "uri": "spotify:artist:4VMYDCV2IEDYJArk749S6m"
        }
      ],
      "album": {
        "id": "5C0YLr4OoRGFDaqdMQmkeH",
        "name": "VIDA",
        "uri": "spotify:album:5C0YLr4OoRGFDaqdMQmkeH",
        "coverArt": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02ef0d4234e1a645740f77d59c",
            "width": 300,
            "height": 300
          },
          {
            "url": "https://i.scdn.co/image/ab67616d00004851ef0d4234e1a645740f77d59c",
            "width": 64,
            "height": 64
          },
          {
            "url": "https://i.scdn.co/image/ab67616d0000b273ef0d4234e1a645740f77d59c",
            "width": 640,
            "height": 640
          }
        ]
      },
      "playability": {
        "playable": true,
        "reason": "PLAYABLE"
      },
      "contentRating": {
        "label": "NONE"
      }
    }
  ],
  "message": "Success",
  "statusCode": 200,
  "pagination": {
    "total": 100,
    "hasMore": true,
    "continuation": "CDsQ8FsiEwje95_F1pmRAxXlsykDHUX"
  }
}

Authorizations

x-rapidapi-key
string
header
required

API Key

Query Parameters

keyword
string
required

Search keyword for tracks, artists, albums

Example:

"despacito"

offset
number

Offset for pagination

Example:

0

limit
number
default:20

Number of results to return

Required range: 1 <= x <= 100
Example:

20

filterBy
enum<string>
default:song

Type of search

Available options:
song,
playlist,
album,
artist,
podcast_show,
profile,
genres_mood
Example:

"song"

Response

Success

data
object[]
required

Array of track search results

message
string
Example:

"Success"

statusCode
number
Example:

200

pagination
object