Get track recommendations

Get recommended tracks based on a specific track

GET /api/v1/tracks/recommendations

Get track recommendations

cURL

curl --request GET \
  --url https://spotify-api31.p.rapidapi.com/api/v1/tracks/recommendations \
  --header 'x-rapidapi-key: <api-key>'

200

{
  "message": "Success",
  "statusCode": 200,
  "pagination": {
    "total": 100,
    "hasMore": true,
    "continuation": "CDsQ8FsiEwje95_F1pmRAxXlsykDHUX"
  },
  "data": [
    {
      "id": "5QTlj4L7ODIKNnTkhDE16p",
      "name": "Rhymes",
      "uri": "spotify:track:5QTlj4L7ODIKNnTkhDE16p",
      "duration": 200005,
      "artists": [
        {
          "name": "Hannah Wants",
          "uri": "spotify:artist:7sK4hnuUOXw6VStDw0q8NI"
        }
      ],
      "album": {
        "id": "4hqlx8mdrCorDXsdzQfmX1",
        "uri": "spotify:album:4hqlx8mdrCorDXsdzQfmX1",
        "name": "Rhymes",
        "coverArt": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02823349c9546161f25941b7c9",
            "width": 300,
            "height": 300
          }
        ]
      },
      "playability": {
        "playable": true,
        "reason": "PLAYABLE"
      },
      "contentRating": {
        "label": "NONE"
      }
    }
  ]
}

Authorizations

x-rapidapi-key · string · header · required

API Key

Query Parameters

uri · string · required

Spotify track URI to get recommendations for

Pattern: ^spotify:track:[a-zA-Z0-9]+$

Example:

"spotify:track:4WNcduiCmDNfmTEz7JvmLv"

limit · number · default: 20

Number of recommendations to return

Required range: 1 <= x <= 50

Example:

20

Response

200

application/json

Success

message · string

Example:

"Success"

statusCode · number

Example:

200

pagination · object

Show child attributes

data · object[]

Recommended tracks information

Show child attributes