Skip to content
Web APIReferences / Albums / Get New Releases

Get New Releases

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

Important policy note

Request

  • country
    string

    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.

    Example value: "SE"
  • limit
    integer

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

    Example value: 10Default value: 20Range: 0 - 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.

    Example value: 5Default value: 0

Response

A paged set of albums

  • Required
    • href
      string
      Required

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

      Example value: "https://api.spotify.com/v1/me/shows?offset=0&limit=20"
    • limit
      integer
      Required

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

      Example value: 20
    • next
      string
      Required
      Nullable

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

      Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • offset
      integer
      Required

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

      Example value: 0
    • previous
      string
      Required
      Nullable

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

      Example value: "https://api.spotify.com/v1/me/shows?offset=1&limit=1"
    • total
      integer
      Required

      The total number of items available to return.

      Example value: 4
    • Required