Albums

Get New Releases

Changed on

Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).

get/browse/new-releases

Request

  • Base URL
    https://api.spotify.com/v1
  • URL
    https://api.spotify.com/v1/browse/new-releases
  • Auth
    OAuth 2
    Authorization code: https://accounts.spotify.com/authorize
    Token URL: https://accounts.spotify.com/api/token

Query parameters

limitinteger

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.

Example:10
offsetinteger

The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

Example:5

Response

A paged set of albums

Example response

{
  "albums": {
    "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",
    "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1",
    "total": 4,
    "items": [
      {
        "album_type": "compilation",
        "total_tracks": 9,
        "available_markets": [
          "CA",
          "BR",
          "IT"
        ],
        "id": "2up3OPMp9Tb4dAKM2erWXQ",
        "images": [
          {
            "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
            "height": 300,
            "width": 300
          }
        ],
        "release_date": "1981-12",
        "release_date_precision": "year",
        "uri": "spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
      }
    ]
  }
}

Changes

  • 8899d6fd66eeRevision changes
    • info

      endpoint deprecated

    • info

      response property albums/allOf[subschema #2]/items/items/allOf[AlbumBase]/available_markets deprecated

  • e9cf66b6f849Revision changes
    • warning

      deleted the query request parameter country

    • warning

      removed the optional property //////// from the response with the status

    • warning

      removed the optional property //////// from the response with the status

    • warning

      removed the optional property //////// from the response with the status

    • warning

      removed the optional property //////// from the response with the status

    • warning

      removed the optional property //////// from the response with the status

    • warning

      removed the optional property ///// from the response with the status