Get Recommendations

Developing

GET

/recommendations

Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details.

Request

Query Params

Header Params

Responses

🟢200On success, the HTTP status code in the response header is `200 OK` and the response body contains a recommendations response object in JSON format.

application/json

Body

🔴500500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/recommendations?seed_artists=&seed_genres=&seed_tracks=' \
--header 'Authorization;'

Response Example

200 - Example 1

{
    "seeds": [
        {
            "afterFilteringSize": 0,
            "afterRelinkingSize": 0,
            "href": "string",
            "id": "string",
            "initialPoolSize": 0,
            "type": "string"
        }
    ],
    "tracks": [
        {
            "album": {
                "album_group": "string",
                "album_type": "string",
                "artists": [
                    {
                        "external_urls": {
                            "spotify": "string"
                        },
                        "href": "string",
                        "id": "string",
                        "name": "string",
                        "type": "string",
                        "uri": "string"
                    }
                ],
                "available_markets": [
                    "string"
                ],
                "external_urls": {
                    "spotify": "string"
                },
                "href": "string",
                "id": "string",
                "images": [
                    {
                        "height": 0,
                        "url": "string",
                        "width": 0
                    }
                ],
                "name": "string",
                "release_date": "string",
                "release_date_precision": "string",
                "restrictions": {
                    "reason": "string"
                },
                "total_tracks": 0,
                "type": "string",
                "uri": "string"
            },
            "artists": [
                {
                    "external_urls": {
                        "spotify": "string"
                    },
                    "followers": {
                        "href": "string",
                        "total": 0
                    },
                    "genres": [
                        "string"
                    ],
                    "href": "string",
                    "id": "string",
                    "images": [
                        {
                            "height": 0,
                            "url": "string",
                            "width": 0
                        }
                    ],
                    "name": "string",
                    "popularity": 0,
                    "type": "string",
                    "uri": "string"
                }
            ],
            "available_markets": [
                "string"
            ],
            "disc_number": 0,
            "duration_ms": 0,
            "explicit": true,
            "external_ids": {
                "ean": "string",
                "isrc": "string",
                "upc": "string"
            },
            "external_urls": {
                "spotify": "string"
            },
            "href": "string",
            "id": "string",
            "is_local": true,
            "is_playable": true,
            "linked_from": {
                "external_urls": {
                    "spotify": "string"
                },
                "href": "string",
                "id": "string",
                "type": "string",
                "uri": "string"
            },
            "name": "string",
            "popularity": 0,
            "preview_url": "string",
            "restrictions": {
                "reason": "string"
            },
            "track_number": 0,
            "type": "string",
            "uri": "string"
        }
    ]
}

Modified at 2022-09-12 10:04:50

Get All New Releases

Get Recommendation Genres