Spotify Web API

Get All New Releases

Developing

GET

/browse/new-releases

category-browse

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.spotify.com/v1/browse/new-releases' \
--header 'Authorization;'

Response Example

200 - Example 1

{
  "albums": {
    "href": "string",
    "items": [
      {
        "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"
      }
    ],
    "limit": 0,
    "next": "string",
    "offset": 0,
    "previous": "string",
    "total": 0
  }
}

Request

Query Params

country

string

optional

A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want the list of returned items to be relevant to a particular country. If omitted, the returned items will be relevant to all countries.

limit

integer

optional

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

offset

integer

optional

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

Header Params

Authorization

string

required

A valid user access token or your client credentials.

Responses

🟢200On success, the HTTP status code in the response header is `200` OK and the response body contains a `message` and an`albums` object. The `albums` object contains an array of simplified [album objects](https://developer.spotify.com/documentation/web-api/r

application/json

Body

albums

object

optional

href

string

optional

A link to the Web API endpoint returning the full result of the request

items

array[object (SimplifiedAlbumObject) {15}]

optional

The requested data.

limit

integer <int32>

optional

The maximum number of items in the response (as set in the query or by default).

string

optional

URL to the next page of items. ( null if none)

offset

integer <int32>

optional

The offset of the items returned (as set in the query or by default)

string

optional

URL to the previous page of items. ( null if none)

total

integer <int32>

optional

The total number of items available to return.

🔴500500

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

Get All Featured Playlists

Get Recommendations