Get Several Audiobooks
Get Spotify catalog information for several audiobooks identified by their Spotify IDs.
Note: Audiobooks are only available for the US, UK, Ireland, New Zealand and Australia markets.
You may not facilitate downloads of Spotify content or enable “stream ripping”
More informationSpotify visual content must be kept in its original form, e.g. you can not crop album artwork, overlay images on album artwork, place a brand/logo on album artwork
More informationPlease keep in mind that metadata, cover art and artist images must be accompanied by a link back to the applicable artist, album, track, or playlist on the Spotify Service. You must also attribute content from Spotify with the logo.
More information
Request
- idsstringRequired
A comma-separated list of the Spotify IDs. For example:
ids=18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ
. Maximum: 50 IDs.Example value:"18yVqkdbdRvS24c0Ilj2ci,1HGw3J3NxZO1TP1BTtVhpZ,7iHfbu1YPACw6oZPAFJtqe"
- 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.
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.
Note: If neither market or user country are provided, the content is considered unavailable for the client.
Users can view the country that is associated with their account in the account settings.Example value:"ES"
Response
A set of audiobooks
- Required
- Required
The author(s) for the audiobook.
- available_marketsarray of stringsRequired
A list of the countries in which the audiobook can be played, identified by their ISO 3166-1 alpha-2 code.
- Required
The copyright statements of the audiobook.
- descriptionstringRequired
A description of the audiobook. HTML tags are stripped away from this field, use
html_description
field in case HTML tags are needed. - html_descriptionstringRequired
A description of the audiobook. This field may contain HTML tags.
- editionstring
The edition of the audiobook.
Example value:"Unabridged"
- explicitbooleanRequired
Whether or not the audiobook has explicit content (true = yes it does; false = no it does not OR unknown).
- Required
External URLs for this audiobook.
- hrefstringRequired
A link to the Web API endpoint providing full details of the audiobook.
- idstringRequired
The Spotify ID for the audiobook.
- Required
The cover art for the audiobook in various sizes, widest first.
- languagesarray of stringsRequired
A list of the languages used in the audiobook, identified by their ISO 639 code.
- media_typestringRequired
The media type of the audiobook.
- namestringRequired
The name of the audiobook.
- Required
The narrator(s) for the audiobook.
- publisherstringRequired
The publisher of the audiobook.
- typestringRequired
The object type.
Allowed values:"audiobook"
- uristringRequired
The Spotify URI for the audiobook.
- total_chaptersintegerRequired
The number of chapters in this audiobook.
- Required
The chapters of the audiobook.