Albums

Get Several Albums

GET
/albums

Get Spotify catalog information for multiple albums identified by their Spotify IDs.

Authorization

oauth_2_0
AuthorizationBearer <token>

Spotify supports OAuth 2.0 for authenticating all API requests.

In: header

Query Parameters

ids*Spotify Album IDs

A comma-separated list of the Spotify IDs for the albums. Maximum: 20 IDs.

market?Market

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned. If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter. Note: If neither market or user country are provided, the content is considered unavailable for the client. Users can view the country that is associated with their account in the account settings.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/albums?ids=382ObEPsp2rxGrnsizN5TX%2C1A2GTWGtFfWp7KSQTwWOyo%2C2noRn2Aes5aoNVsU6iWThc"
{  "albums": [    {      "album_type": "compilation",      "total_tracks": 9,      "available_markets": [        "CA",        "BR",        "IT"      ],      "external_urls": {        "spotify": "string"      },      "href": "string",      "id": "2up3OPMp9Tb4dAKM2erWXQ",      "images": [        {          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",          "height": 300,          "width": 300        }      ],      "name": "string",      "release_date": "1981-12",      "release_date_precision": "year",      "restrictions": {        "reason": "market"      },      "type": "album",      "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ",      "artists": [        {          "external_urls": {            "spotify": "string"          },          "href": "string",          "id": "string",          "name": "string",          "type": "artist",          "uri": "string"        }      ],      "tracks": {        "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20\n",        "limit": 20,        "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",        "offset": 0,        "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",        "total": 4,        "items": [          {            "artists": [              {                "external_urls": {                  "spotify": "string"                },                "href": "string",                "id": "string",                "name": "string",                "type": "artist",                "uri": "string"              }            ],            "available_markets": [              "string"            ],            "disc_number": 0,            "duration_ms": 0,            "explicit": true,            "external_urls": {              "spotify": "string"            },            "href": "string",            "id": "string",            "is_playable": true,            "linked_from": {              "external_urls": {                "spotify": "string"              },              "href": "string",              "id": "string",              "type": "string",              "uri": "string"            },            "restrictions": {              "reason": "string"            },            "name": "string",            "preview_url": "string",            "track_number": 0,            "type": "string",            "uri": "string",            "is_local": true          }        ]      },      "copyrights": [        {          "text": "string",          "type": "string"        }      ],      "external_ids": {        "isrc": "string",        "ean": "string",        "upc": "string"      },      "genres": [        "Egg punk",        "Noise rock"      ],      "label": "string",      "popularity": 0    }  ]}