Skip to content
Web API •References / 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: country=SE
  • limit
    integer

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

    Default: limit=20Range: 0 - 50Example: limit=10
  • 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.

    Default: offset=0Example: offset=5

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: "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: 20
    • next
      string
      Required
      Nullable

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

      Example: "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: 0
    • previous
      string
      Required
      Nullable

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

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

      The total number of items available to return.

      Example: 4
    • Required
      • album_type
        string
        Required

        The type of the album.

        Allowed values: "album", "single", "compilation"Example: "compilation"
      • total_tracks
        integer
        Required

        The number of tracks in the album.

        Example: 9
      • available_markets
        array of strings
        Required

        The markets in which the album is available: ISO 3166-1 alpha-2 country codes. NOTE: an album is considered available in a market when at least 1 of its tracks is available in that market.

        Example: ["CA","BR","IT"]
      • Required

        Known external URLs for this album.

      • href
        string
        Required

        A link to the Web API endpoint providing full details of the album.

      • id
        string
        Required

        The Spotify ID for the album.

        Example: "2up3OPMp9Tb4dAKM2erWXQ"
      • Required

        The cover art for the album in various sizes, widest first.

        • url
          string
          Required

          The source URL of the image.

          Example: "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228"
        • height
          integer
          Required
          Nullable

          The image height in pixels.

          Example: 300
        • width
          integer
          Required
          Nullable

          The image width in pixels.

          Example: 300
      • 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.

        Example: "1981-12"
      • release_date_precision
        string
        Required

        The precision with which release_date value is known.

        Allowed values: "year", "month", "day"Example: "year"

      • Included in the response when a content restriction is applied.

        • reason
          string

          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.

          Allowed values: "market", "product", "explicit"
      • type
        string
        Required

        The object type.

        Allowed values: "album"
      • uri
        string
        Required

        The Spotify URI for the album.

        Example: "spotify:album:2up3OPMp9Tb4dAKM2erWXQ"
      • Required

        The artists of the album. Each artist object includes a link in href to more detailed information about the artist.

        • Known external URLs for this artist.

        • href
          string

          A link to the Web API endpoint providing full details of the artist.

        • id
          string

          The Spotify ID for the artist.

        • name
          string

          The name of the artist.

        • type
          string

          The object type.

          Allowed values: "artist"
        • uri
          string

          The Spotify URI for the artist.