Get Recommendations

GET

/recommendations

category-browse

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.

请求示例

Shell

JavaScript

Java

Swift

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

响应示例

200 - 示例 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"
    }
  ]
}

请求参数

Query 参数

limit

可选

The target size of the list of recommended tracks. For seeds with unusually small pools or when highly restrictive filtering is applied, it may be impossible to generate the requested number of recommended tracks. Debugging information for such cases is available in the response. Default: 20. Minimum: 1. Maximum: 100.

market

可选

An ISO 3166-1 alpha-2 country code or the string from_token. Provide this parameter if you want to apply Track Relinking. Because min_*, max_* and target_* are applied to pools before relinking, the generated results may not precisely match the filters applied. Original, non-relinked tracks are available via the linked_from attribute of the relinked track response.

seed_artists

必需

A comma separated list of Spotify IDs for seed artists. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

seed_genres

必需

A comma separated list of any genres in the set of available genre seeds. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

seed_tracks

必需

A comma separated list of Spotify IDs for a seed track. Up to 5 seed values may be provided in any combination of seed_artists, seed_tracks and seed_genres.

min_acousticness

可选

For each tunable track attribute, a hard floor on the selected track attribute's value can be provided. See tunable track attributes below for the list of available options. For example, min_tempo=140 would restrict results to only those tracks with a tempo of greater than 140 beats per minute.

max_acousticness

可选

For each tunable track attribute, a hard ceiling on the selected track attribute's value can be provided. See tunable track attributes below for the list of available options. For example, max_instrumentalness=0.35 would filter out most tracks that are likely to be instrumental.

target_acousticness

可选

For each of the tunable track attributes (below) a target value may be provided. Tracks with the attribute values nearest to the target values will be preferred. For example, you might request target_energy=0.6 and target_danceability=0.8. All target values will be weighed equally in ranking results.

min_danceability

可选

max_danceability

可选

target_danceability

可选

min_duration_ms

可选

max_duration_ms

可选

target_duration_ms

可选

Target duration of the track (ms)

min_energy

可选

max_energy

可选

target_energy

可选

min_instrumentalness

可选

max_instrumentalness

可选

target_instrumentalness

可选

min_key

可选

max_key

可选

target_key

可选

min_liveness

可选

max_liveness

可选

target_liveness

可选

min_loudness

可选

max_loudness

可选

target_loudness

可选

min_mode

可选

max_mode

可选

target_mode

可选

min_popularity

可选

max_popularity

可选

target_popularity

可选

min_speechiness

可选

max_speechiness

可选

target_speechiness

可选

min_tempo

可选

max_tempo

可选

target_tempo

可选

Target tempo (BPM)

min_time_signature

可选

max_time_signature

可选

target_time_signature

可选

min_valence

可选

max_valence

可选

target_valence

可选

Header 参数

Authorization

必需

A valid user access token or your client credentials.

返回响应

🟢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

seeds

array[object (RecommendationSeedObject) {6}]

可选

An array of recommendation seed objects.

afterFilteringSize

integer <int32>

可选

The number of tracks available after min_* and max_* filters have been applied.

afterRelinkingSize

integer <int32>

可选

The number of tracks available after relinking for regional availability.

href

string

可选

A link to the full track or artist data for this seed. For tracks this will be a link to a Track Object. For artists a link to an Artist Object. For genre seeds, this value will be null.

string

可选

The id used to select this seed. This will be the same as the string used in the seed_artists, seed_tracks or seed_genres parameter.

initialPoolSize

integer <int32>

可选

The number of recommended tracks available for this seed.

type

string

可选

The entity type of this seed. One of artist, track or genre.

tracks

array[object (TrackObject) {20}]

可选

An array of track object ordered according to the parameters supplied.

album

object (SimplifiedAlbumObject)

可选

artists

array[object (ArtistObject) {10}]

可选

The artists who performed the track. Each artist object includes a link in href to more detailed information about the artist.

available_markets

array[string]

可选

A list of the countries in which the track can be played, identified by their ISO 3166-1 alpha-2 code.

disc_number

integer <int32>

可选

The disc number (usually 1 unless the album consists of more than one disc).

duration_ms

integer <int32>

可选

The track length in milliseconds.

explicit

boolean

可选

Whether or not the track has explicit lyrics ( true = yes it does; false = no it does not OR unknown).

external_ids

object (ExternalIdObject)

可选

external_urls

object (ExternalUrlObject)

可选

href

string

可选

A link to the Web API endpoint providing full details of the track.

string

可选

The Spotify ID for the track.

is_local

boolean

可选

Whether or not the track is from a local file.

is_playable

boolean

可选

Part of the response when Track Relinking is applied. If true , the track is playable in the given market. Otherwise false.

linked_from

object (LinkedTrackObject)

可选

name

string

可选

The name of the track.

popularity

integer <int32>

可选

The popularity of the track. The value will be between 0 and 100, with 100 being the most popular.
The popularity of a track is a value between 0 and 100, with 100 being the most popular. The popularity is calculated by algorithm and is based, in the most part, on the total number of plays the track has had and how recent those plays are.
Generally speaking, songs that are being played a lot now will have a higher popularity than songs that were played a lot in the past. Duplicate tracks (e.g. the same track from a single and an album) are rated independently. Artist and album popularity is derived mathematically from track popularity. Note that the popularity value may lag actual popularity by a few days: the value is not updated in real time.

preview_url

string

可选

A link to a 30 second preview (MP3 format) of the track. Can be null

restrictions

object (TrackRestrictionObject)

可选

track_number

integer <int32>

可选

The number of the track. If an album has several discs, the track number is the number on the specified disc.

type

string

可选

The object type: "track".

uri

string

可选

The Spotify URI for the track.

🔴500500

Get All New Releases

Get Recommendation Genres