### Get Categories (Wget) Source: https://developer.spotify.com/documentation/web-api/reference/get-categories This example shows how to fetch categories using Wget. Replace the placeholder with your actual authorization token. ```bash wget --header="Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z" -O - "https://api.spotify.com/v1/browse/categories" ``` -------------------------------- ### Get Categories (HTTPie) Source: https://developer.spotify.com/documentation/web-api/reference/get-categories An example using HTTPie to make a GET request for categories. Remember to substitute your valid authorization token. ```bash http GET https://api.spotify.com/v1/browse/categories \ Authorization:Bearer 1POdFZRZbvb...qqillRxMr2z ``` -------------------------------- ### Get Top Artists (Wget) Source: https://developer.spotify.com/documentation/web-api/reference/get-users-top-artists-and-tracks This example shows how to fetch the current user's top artists using Wget. A valid authorization token is required. ```bash wget --method=GET --header='Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' 'https://api.spotify.com/v1/me/top/artists' ``` -------------------------------- ### Get User's Saved Tracks (Wget) Source: https://developer.spotify.com/documentation/web-api/reference/get-users-saved-tracks This example shows how to fetch a user's saved tracks using Wget. Replace the placeholder with your actual authorization token. ```bash wget --header="Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z" https://api.spotify.com/v1/me/tracks ``` -------------------------------- ### Get Top Artists (HTTPie) Source: https://developer.spotify.com/documentation/web-api/reference/get-users-top-artists-and-tracks An example using HTTPie to get the current user's top artists. Remember to replace the placeholder with your actual authorization token. ```bash http GET https://api.spotify.com/v1/me/top/artists \ Authorization:'Bearer 1POdFZRZbvb...qqillRxMr2z' ``` -------------------------------- ### Get Devices Response Sample Source: https://developer.spotify.com/documentation/web-api/reference/get-a-users-available-devices This is an example of the JSON response you can expect when successfully retrieving a user's devices. It includes details for each device. ```json { "devices": [ { "id": "string", "is_active": false, "is_private_session": false, "is_restricted": false, "name": "Kitchen speaker", "type": "computer", "volume_percent": 59, "supports_volume": false } ] } ``` -------------------------------- ### Get User Profile (HTTPie) Source: https://developer.spotify.com/documentation/web-api/reference/get-users-profile An example using HTTPie to request a user's profile. This command requires the Authorization header with a valid bearer token. ```bash http GET https://api.spotify.com/v1/users/smedjan \ Authorization:Bearer 1POdFZRZbvb...qqillRxMr2z ``` -------------------------------- ### Example Response for Get a User's Playlists Source: https://developer.spotify.com/documentation/web-api/reference/get-a-categories-playlists This JSON object represents a successful response when retrieving a list of playlists. It includes metadata about the playlists and a list of individual playlist objects. ```json { "message": "Popular Playlists", "playlists": { "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "collaborative": false, "description": "string", "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "name": "string", "owner": { "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "type": "user", "uri": "string", "display_name": "string" }, "public": false, "snapshot_id": "string", "items": { "href": "string", "total": 0 }, "tracks": { "href": "string", "total": 0 }, "type": "string", "uri": "string" } ] } } ``` -------------------------------- ### Follow a Playlist (Wget) Source: https://developer.spotify.com/documentation/web-api/reference/follow-playlist This example demonstrates how to follow a playlist using Wget. It requires the same authentication and data payload as the cURL example. ```bash wget --method=PUT --header="Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z" --header="Content-Type: application/json" --body-data="{\"public\": false}" https://api.spotify.com/v1/playlists/3cEYpjA9oz9GiPac4AsH4n/followers ``` -------------------------------- ### Get Audiobook Chapters Source: https://developer.spotify.com/documentation/web-api/reference/get-audiobook-chapters This example demonstrates how to retrieve chapters for a given audiobook using a GET request. It includes the necessary authorization header. ```APIDOC ## GET /v1/audiobooks/{id}/chapters ### Description Retrieves a list of chapters for a specific audiobook. ### Method GET ### Endpoint /v1/audiobooks/{id}/chapters ### Parameters #### Path Parameters - **id** (string) - Required - The Spotify ID for the audiobook. #### Request Example ```http GET https://api.spotify.com/v1/audiobooks/7iHfbu1YPACw6oZPAFJtqe/chapters Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z ``` ### Response #### Success Response (200) - **href** (string) - URL to the endpoint containing the next page of results. - **limit** (integer) - The maximum number of items to return. Defaults to 20, max is 50. - **next** (string) - URL to the next page of items. If null, there is no next page. - **offset** (integer) - The offset from the start of the resource. Defaults to 0. - **previous** (string) - URL to the previous page of items. If null, there is no previous page. - **total** (integer) - The total number of items available through the API. - **items** (array) - An array of audiobook chapter objects. - **audio_preview_url** (string) - URL to a 30-second preview (mp3 format) of the chapter. - **available_markets** (array) - An array of country codes where the chapter is available. - **chapter_number** (integer) - The number of the chapter. - **description** (string) - The description of the chapter. - **html_description** (string) - A plain text description of the chapter, with HTML tags. - **duration_ms** (integer) - The duration of the chapter in milliseconds. - **explicit** (boolean) - Whether or not the content has been marked as explicit. - **external_urls** (object) - Known external URLs for this chapter. - **spotify** (string) - A URL pointing to the Spotify page for the chapter. - **href** (string) - A link to the Web API endpoint providing full details of the chapter. - **id** (string) - The Spotify ID for the chapter. - **images** (array) - An array of images associated with the chapter. - **url** (string) - The source URL of the image. - **height** (integer) - The height of the image in pixels. - **width** (integer) - The width of the image in pixels. - **is_playable** (boolean) - Whether or not the episode is playable in the given market. True if playable, false otherwise. - **languages** (array) - A list of the languages used in the chapter. - **name** (string) - The name of the chapter. - **release_date** (string) - The date the chapter was released. - **release_date_precision** (string) - The precision with which release_date will be available. - **resume_point** (object) - The user's most recent position in the chapter. - **fully_played** (boolean) - Whether or not the episode has been fully played by the user. - **resume_position_ms** (integer) - The user's resume point in the chapter. - **type** (string) - The object type. - **uri** (string) - The Spotify URI for the chapter. - **restrictions** (object) - Any restrictions for the chapter. - **reason** (string) - The reason for the restriction. #### Response Example ```json { "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17", "available_markets": ["string"], "chapter_number": 1, "description": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.", "html_description": "

We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.

", "duration_ms": 1686230, "explicit": false, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_playable": false, "languages": ["fr", "en"], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": false, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" } } ] } ``` ``` -------------------------------- ### Navigate and Install Dependencies Source: https://developer.spotify.com/documentation/web-api/howtos/web-app-profile Changes the directory to the newly created Vite project and installs the necessary npm packages. ```bash cd spotify-profile-demo npm install ``` -------------------------------- ### Get User's Saved Tracks (HTTPie) Source: https://developer.spotify.com/documentation/web-api/reference/get-users-saved-tracks An example using HTTPie to get a user's saved tracks. The Authorization header is crucial for authentication. ```bash http GET https://api.spotify.com/v1/me/tracks \ Authorization:Bearer 1POdFZRZbvb...qqillRxMr2z ``` -------------------------------- ### Start Vite Development Server Source: https://developer.spotify.com/documentation/web-api/howtos/web-app-profile Starts the Vite development server to run the web application locally. ```bash npm run dev ``` -------------------------------- ### Get Followed Artists (cURL) Source: https://developer.spotify.com/documentation/web-api/reference/get-followed Example of how to retrieve a list of followed artists using cURL. Ensure you include your Authorization token. ```bash curl --request GET \ --url 'https://api.spotify.com/v1/me/following?type=artist' \ --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' ``` -------------------------------- ### Follow a Playlist (HTTPie) Source: https://developer.spotify.com/documentation/web-api/reference/follow-playlist An example using HTTPie to follow a playlist. HTTPie offers a more user-friendly syntax for making HTTP requests. ```bash http PUT https://api.spotify.com/v1/playlists/3cEYpjA9oz9GiPac4AsH4n/followers \ Authorization:Bearer 1POdFZRZbvb...qqillRxMr2z \ Content-Type:application/json \ 'public:=false' ``` -------------------------------- ### Pagination Example Source: https://developer.spotify.com/documentation/web-api/concepts/api-calls Shows how to use offset and limit query parameters to paginate through datasets in API endpoints. ```APIDOC ## Pagination Example This example demonstrates how to retrieve a specific subset of results from an endpoint that supports pagination using `offset` and `limit` query parameters. ### Endpoint `https://api.spotify.com/v1/artists/1vCWHaC5f2uS3yhpwWbIA6/albums?album_type=SINGLE&offset=20&limit=10` ### Description This request retrieves the next 10 single albums (specified by `limit=10`) starting from the 20th album (specified by `offset=20`) in the list of albums for the artist with ID `1vCWHaC5f2uS3yhpwWbIA6`. ``` -------------------------------- ### Get Several Tracks' Audio Features Example Source: https://developer.spotify.com/documentation/web-api/reference/get-several-audio-features Demonstrates how to request audio features for a list of track IDs. Ensure the IDs are comma-separated and do not exceed 100. ```http GET https://api.spotify.com/v1/audio-features?ids=7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,2takcwOaAZWiXQijPHIx7B ``` -------------------------------- ### Show Response Sample Source: https://developer.spotify.com/documentation/web-api/reference/get-a-show This is an example of the JSON response you can expect when successfully retrieving show information. It includes details like available markets, description, images, and a list of episodes. ```json { "available_markets": ["string"], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "html_description": "string", "explicit": false, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_externally_hosted": false, "languages": ["string"], "media_type": "string", "name": "string", "publisher": "string", "type": "show", "uri": "string", "total_episodes": 0, "episodes": { "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17", "description": "A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.", "html_description": "

A Spotify podcast sharing fresh insights on important topics of the moment—in a way only Spotify can. You’ll hear from experts in the music, podcast and tech industries as we discover and uncover stories about our work and the world around us.

", "duration_ms": 1686230, "explicit": false, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_externally_hosted": false, "is_playable": false, "language": "en", "languages": ["fr", "en"], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": false, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" } } ] }} ``` -------------------------------- ### Get Available Markets Response Sample Source: https://developer.spotify.com/documentation/web-api/reference/get-available-markets This is an example of a successful response from the /markets endpoint, showing an object containing an array of country codes representing the available markets. ```json { "markets": ["CA", "BR", "IT"] } ``` -------------------------------- ### Skip to Previous Track (Wget) Source: https://developer.spotify.com/documentation/web-api/reference/skip-users-playback-to-previous-track This example shows how to use Wget to make a POST request to the 'Skip to Previous' endpoint. Replace the placeholder token with your actual OAuth token. ```bash wget --method POST --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' --url https://api.spotify.com/v1/me/player/previous --no-check-certificate ``` -------------------------------- ### cURL Request to Start Playback Source: https://developer.spotify.com/documentation/web-api/reference/start-a-users-playback This cURL command demonstrates how to send a PUT request to the /me/player/play endpoint. Include your Authorization token and the JSON body to control playback. ```bash curl --request PUT \ --url https://api.spotify.com/v1/me/player/play \ --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' \ --header 'Content-Type: application/json' \ --data '{ \ "context_uri": "spotify:album:5ht7ItJgpBH7W6vJ5BqpPr", \ "offset": { \ "position": 5 \ }, \ "position_ms": 0 \ }' ``` -------------------------------- ### Check if tracks are saved Source: https://developer.spotify.com/documentation/web-api/reference/check-users-saved-tracks This example demonstrates how to check if tracks are saved in the user's library using their IDs. It sends a GET request to the /v1/me/tracks/contains endpoint with the track IDs as a query parameter. ```APIDOC ## GET /v1/me/tracks/contains ### Description Checks if one or more tracks are saved to the current Spotify user's library. ### Method GET ### Endpoint /v1/me/tracks/contains ### Parameters #### Query Parameters - **ids** (string) - Required - A comma-separated list of Spotify IDs for the tracks. Maximum of 50 IDs. ### Request Example ```http GET https://api.spotify.com/v1/me/tracks/contains?ids=7ouMYWpwJ422jRcDASZB7P%2C4VqPOruhp5EdPBeR92t6lQ%2C2takcwOaAZWiXQijPHIx7B Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z ``` ### Response #### Success Response (200) - Returns a boolean array. The order of the booleans corresponds to the order of the track IDs in the request. `true` if the track is saved, `false` otherwise. #### Response Example ```json [ false, true ] ``` ``` -------------------------------- ### Get Top Artists or Tracks Source: https://developer.spotify.com/documentation/web-api/reference/get-users-top-artists-and-tracks Fetches the current user's top artists or tracks. You can specify the type of entity (artists or tracks), the time range, and control the number of results and the starting offset. ```APIDOC ## GET /me/top/{type} ### Description Retrieve the current user's top artists or tracks based on their listening activity. ### Method GET ### Endpoint /me/top/{type} ### Parameters #### Path Parameters - **type** (string) - Required - The type of entity to return. Valid values: `artists` or `tracks` #### Query Parameters - **time_range** (string) - Optional - Over what time frame the affinities are computed. Valid values: `long_term`, `medium_term`, `short_term`. Default: `medium_term` - **limit** (integer) - Optional - The maximum number of items to return. Minimum: 1. Maximum: 50. Default: 20 - **offset** (integer) - Optional - The index of the first item to return. Default: 0 ### Response #### Success Response (200) - **items** (array) - A list of the user's top artists or tracks. - **total** (integer) - The total number of items available. - **next** (string) - A link to the next page of results, or null if there is no next page. - **previous** (string) - A link to the previous page of results, or null if there is no previous page. - **limit** (integer) - The limit that was sent in the query. - **offset** (integer) - The offset that was sent in the query. ### Response Example ```json { "items": [ { "name": "Artist Name", "id": "artist_id", "genres": ["pop", "rock"], "popularity": 80, "images": [ { "url": "https://example.com/image.jpg", "height": 300, "width": 300 } ] } ], "total": 50, "next": "https://api.spotify.com/v1/me/top/artists?limit=20&offset=20&time_range=medium_term", "previous": null, "limit": 20, "offset": 0 } ``` ``` -------------------------------- ### Transfer Playback using cURL Source: https://developer.spotify.com/documentation/web-api/reference/transfer-a-users-playback Example of how to transfer playback to a new device using cURL. Ensure you replace '1POdFZRZbvb...qqillRxMr2z' with a valid OAuth token. ```bash curl --request PUT \ --url https://api.spotify.com/v1/me/player \ --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' \ --header 'Content-Type: application/json' \ --data '{ \ "device_ids": [ \ "74ASZWbe4lXaubB36ztrGX" \ ] \ }' ``` -------------------------------- ### Get Audiobooks by IDs Source: https://developer.spotify.com/documentation/web-api/reference/get-multiple-audiobooks This example demonstrates how to retrieve multiple audiobooks using their IDs. The IDs are passed as a comma-separated string in the `ids` query parameter. An `Authorization` header with a valid Bearer token is required. ```APIDOC ## GET https://api.spotify.com/v1/audiobooks ### Description Retrieves information about one or more audiobooks based on their Spotify IDs. ### Method GET ### Endpoint https://api.spotify.com/v1/audiobooks ### Parameters #### Query Parameters - **ids** (string) - Required - A comma-separated list of Spotify IDs for the audiobooks. Maximum of 50 IDs. - **market** (string) - Optional - An ISO 3166-1 alpha-2 country code. Provide this parameter if you want the API to return only tracks available in that market. If a country code is specified, the object will be returned in the specified country. Otherwise, the object will be returned in the default market: the US. If the country code is invalid, the response will be returned in the US market. ### Request Example ```http GET https://api.spotify.com/v1/audiobooks?ids=18yVqkdbdRvS24c0Ilj2ci%2C1HGw3J3NxZO1TP1BTtVhpZ%2C7iHfbu1YPACw6oZPAFJtqe ``` ### Headers - **Authorization** (string) - Required - Bearer token for authentication. ### Response #### Success Response (200) - **audiobooks** (array) - An array of audiobook objects. - **authors** (array) - The artists or authors of the audiobook. - **available_markets** (array) - The markets in which the audiobook is available. - **copyrights** (array) - The copyrights for the audiobook. - **description** (string) - The description of the audiobook. - **html_description** (string) - The HTML formatted description of the audiobook. - **edition** (string) - The edition of the audiobook. - **explicit** (boolean) - Whether the audiobook contains explicit content. - **external_urls** (object) - Known external URLs for the audiobook. - **href** (string) - A link to the Web API endpoint providing full information of the audiobook. - **id** (string) - The Spotify ID for the audiobook. - **images** (array) - An array of images for the audiobook. - **languages** (array) - The languages the audiobook is available in. - **media_type** (string) - The media type of the audiobook. - **name** (string) - The name of the audiobook. - **narrators** (array) - The narrators of the audiobook. - **publisher** (string) - The publisher of the audiobook. - **type** (string) - The type of object (e.g., "audiobook"). - **uri** (string) - The Spotify URI for the audiobook. - **total_chapters** (integer) - The total number of chapters in the audiobook. - **chapters** (object) - Information about the chapters of the audiobook. #### Response Example ```json { "audiobooks": [ { "authors": [ { "name": "string" } ], "available_markets": ["string"], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "html_description": "string", "edition": "Unabridged", "explicit": false, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "languages": ["string"], "media_type": "string", "name": "string", "narrators": [ { "name": "string" } ], "publisher": "string", "type": "audiobook", "uri": "string", "total_chapters": 0, "chapters": { "href": "https://api.spotify.com/v1/me/shows?offset=0&limit=20", "limit": 20, "next": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "offset": 0, "previous": "https://api.spotify.com/v1/me/shows?offset=1&limit=1", "total": 4, "items": [ { "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17", "available_markets": ["string"], "chapter_number": 1, "description": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.", "html_description": "

We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonlit sky.

", "duration_ms": 1686230, "explicit": false, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_playable": false, "languages": ["fr", "en"], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": false, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" } } ] } } ] } ``` ``` -------------------------------- ### Fetch Track Information Error Example Source: https://developer.spotify.com/documentation/web-api/concepts/api-calls This example demonstrates the response when trying to fetch information for a non-existent track, resulting in a 400 Bad Request error with a JSON body detailing the issue. ```bash $ curl -i "https://api.spotify.com/v1/tracks/2KrxsD86ARO5beq7Q0Drfqa" HTTP/1.1 400 Bad Request { "error": { "status": 400, "message": "invalid id" } } ``` -------------------------------- ### Check User's Saved Shows Request Example (cURL) Source: https://developer.spotify.com/documentation/web-api/reference/check-users-saved-shows This cURL command demonstrates how to make a GET request to the deprecated 'Check User's Saved Shows' endpoint. It includes the necessary Authorization header and the 'ids' query parameter for specifying the shows to check. Maximum 50 IDs can be provided. ```bash curl --request GET \ --url 'https://api.spotify.com/v1/me/shows/contains?ids=5CfCWKI5pZ28U0uOzXkDHe%2C5as3aDivDDDSrvaZ' \ --header 'Authorization: Bearer 1POdFZRZbvb...qqillRxMr2z' ``` -------------------------------- ### Chapter Response Sample Source: https://developer.spotify.com/documentation/web-api/reference/get-a-chapter This is an example of the JSON response you will receive when successfully requesting chapter information. It includes details like audio preview URL, chapter number, description, duration, and more. ```json { "audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17", "available_markets": ["string"], "chapter_number": 1, "description": "We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonless sky.", "html_description": "

We kept on ascending, with occasional periods of quick descent, but in the main always ascending. Suddenly, I became conscious of the fact that the driver was in the act of pulling up the horses in the courtyard of a vast ruined castle, from whose tall black windows came no ray of light, and whose broken battlements showed a jagged line against the moonless sky.

", "duration_ms": 1686230, "explicit": false, "external_urls": { "spotify": "string" }, "href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ", "id": "5Xt5DXGzch68nYYamXrNxZ", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "is_playable": false, "languages": ["fr", "en"], "name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators", "release_date": "1981-12-15", "release_date_precision": "day", "resume_point": { "fully_played": false, "resume_position_ms": 0 }, "type": "episode", "uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr", "restrictions": { "reason": "string" }, "audiobook": { "authors": [ { "name": "string" } ], "available_markets": ["string"], "copyrights": [ { "text": "string", "type": "string" } ], "description": "string", "html_description": "string", "edition": "Unabridged", "explicit": false, "external_urls": { "spotify": "string" }, "href": "string", "id": "string", "images": [ { "url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228", "height": 300, "width": 300 } ], "languages": ["string"], "media_type": "string", "name": "string", "narrators": [ { "name": "string" } ], "publisher": "string", "type": "audiobook", "uri": "string", "total_chapters": 0 } } ```