Shows

Get Several Shows

Changed on

Get Spotify catalog information for several shows based on their Spotify IDs.

get/shows

Request

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

Query parameters

marketstring

An ISO 3166-1 alpha-2 country code. If a country code is specified, only content that is available in that market will be returned.<br/> If a valid user access token is specified in the request header, the country associated with the user account will take priority over this parameter.<br/> Note: If neither market or user country are provided, the content is considered unavailable for the client.<br/> Users can view the country that is associated with their account in the account settings.

Example:ES
idsstring required

A comma-separated list of the Spotify IDs for the shows. Maximum: 50 IDs.

Example:5CfCWKI5pZ28U0uOzXkDHe,5as3aKmN2k11yfDDDSrvaZ

Response

A set of shows

Example response

{
  "shows": [
    {
      "images": [
        {
          "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
          "height": 300,
          "width": 300
        }
      ]
    }
  ]
}

Changes

  • 8899d6fd66eeRevision changes
    • info

      endpoint deprecated

    • info

      response property shows/items/allOf[ShowBase]/available_markets deprecated

    • info

      response property shows/items/allOf[ShowBase]/publisher deprecated