---
title: "Get New Releases"
method: GET
path: "/browse/new-releases"
tags: ["Albums"]
deprecated: true
---

# Get New Releases

`GET /browse/new-releases`

> **Deprecated.**

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

## Query parameters

- `limit` integer — The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
- `offset` integer — The index of the first item to return. Default: 0 (the first item). Use with limit to get the next set of items.

## Response `200`

A paged set of albums

- object
  - `albums` PagingSimplifiedAlbumObject, required
    - `href` string, required — A link to the Web API endpoint returning the full result of the request
    - `limit` integer, required — The maximum number of items in the response (as set in the query or by default).
    - `next` string, nullable, required — URL to the next page of items. ( `null` if none)
    - `offset` integer, required — The offset of the items returned (as set in the query or by default)
    - `previous` string, nullable, required — URL to the previous page of items. ( `null` if none)
    - `total` integer, required — The total number of items available to return.
    - `items` SimplifiedAlbumObject[], required
      - `album_type` 'album' | 'single' | 'compilation', required — The type of the album.
      - `total_tracks` integer, required — The number of tracks in the album.
      - `available_markets` string[], required — The markets in which the album is available: [ISO 3166-1 alpha-2 country codes](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). _**NOTE**: an album is considered available in a market when at least 1 of its tracks is available in that market._
      - `external_urls` ExternalUrlObject, required
        - `spotify` string — The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.
      - `href` string, required — A link to the Web API endpoint providing full details of the album.
      - `id` string, required — The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the album.
      - `images` ImageObject[], required — The cover art for the album in various sizes, widest first.
        - `url` string, required — The source URL of the image.
        - `height` integer, nullable, required — The image height in pixels.
        - `width` integer, nullable, required — The image width in pixels.
      - `name` string, required — The name of the album. In case of an album takedown, the value may be an empty string.
      - `release_date` string, required — The date the album was first released.
      - `release_date_precision` 'year' | 'month' | 'day', required — The precision with which `release_date` value is known.
      - `restrictions` AlbumRestrictionObject
        - `reason` 'market' | 'product' | 'explicit' — The reason for the restriction. Albums may be restricted if the content is not available in a given market, to the user's subscription type, or when the user's account is set to not play explicit content. Additional reasons may be added in the future.
      - `type` 'album', required — The object type.
      - `uri` string, required — The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the album.
      - `artists` SimplifiedArtistObject[], required — The artists of the album. Each artist object includes a link in `href` to more detailed information about the artist.
        - `external_urls` ExternalUrlObject
          - `spotify` string — The [Spotify URL](/documentation/web-api/concepts/spotify-uris-ids) for the object.
        - `href` string — A link to the Web API endpoint providing full details of the artist.
        - `id` string — The [Spotify ID](/documentation/web-api/concepts/spotify-uris-ids) for the artist.
        - `name` string — The name of the artist.
        - `type` 'artist' — The object type.
        - `uri` string — The [Spotify URI](/documentation/web-api/concepts/spotify-uris-ids) for the artist.

## Other responses

- `401` — Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.
- `403` — Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.
- `429` — The app has exceeded its rate limits.

---

[API](https://skmtc.dev/spotify/apis/spotify-web-api.md) · [All operations](https://skmtc.dev/spotify/apis/spotify-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spotify/spotify-web-api/revisions/2d888d731358/schema)