Get Several Chapters
chapters().bulkRetrieve(ChapterBulkRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none()) : ChapterBulkRetrieveResponse
GET/chapters
Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
Parameters
Returns
Get Several Chapters
package dev.cjav.spotted.example
import dev.cjav.spotted.client.SpottedClient
import dev.cjav.spotted.client.okhttp.SpottedOkHttpClient
import dev.cjav.spotted.models.chapters.ChapterBulkRetrieveParams
import dev.cjav.spotted.models.chapters.ChapterBulkRetrieveResponse
fun main() {
val client: SpottedClient = SpottedOkHttpClient.fromEnv()
val params: ChapterBulkRetrieveParams = ChapterBulkRetrieveParams.builder()
.ids("0IsXVP0JmcB2adSE338GkK,3ZXb8FKZGU0EHALYX6uCzU,0D5wENdkdwbqlrHoaJ9g29")
.build()
val response: ChapterBulkRetrieveResponse = client.chapters().bulkRetrieve(params)
}{
"chapters": [
{
"id": "5Xt5DXGzch68nYYamXrNxZ",
"audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17",
"audiobook": {
"id": "id",
"authors": [
{
"name": "name",
"published": true
}
],
"available_markets": [
"string"
],
"copyrights": [
{
"published": true,
"text": "text",
"type": "type"
}
],
"description": "description",
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "href",
"html_description": "html_description",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"languages": [
"string"
],
"media_type": "media_type",
"name": "name",
"narrators": [
{
"name": "name",
"published": true
}
],
"publisher": "publisher",
"total_chapters": 0,
"type": "audiobook",
"uri": "uri",
"edition": "Unabridged",
"published": true
},
"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.\n",
"duration_ms": 1686230,
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
"html_description": "<p>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.</p>\n",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"is_playable": true,
"languages": [
"fr",
"en"
],
"name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators\n",
"release_date": "1981-12-15",
"release_date_precision": "day",
"type": "episode",
"uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr",
"available_markets": [
"string"
],
"published": true,
"restrictions": {
"published": true,
"reason": "reason"
},
"resume_point": {
"fully_played": true,
"published": true,
"resume_position_ms": 0
}
}
]
}Returns Examples
{
"chapters": [
{
"id": "5Xt5DXGzch68nYYamXrNxZ",
"audio_preview_url": "https://p.scdn.co/mp3-preview/2f37da1d4221f40b9d1a98cd191f4d6f1646ad17",
"audiobook": {
"id": "id",
"authors": [
{
"name": "name",
"published": true
}
],
"available_markets": [
"string"
],
"copyrights": [
{
"published": true,
"text": "text",
"type": "type"
}
],
"description": "description",
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "href",
"html_description": "html_description",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"languages": [
"string"
],
"media_type": "media_type",
"name": "name",
"narrators": [
{
"name": "name",
"published": true
}
],
"publisher": "publisher",
"total_chapters": 0,
"type": "audiobook",
"uri": "uri",
"edition": "Unabridged",
"published": true
},
"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.\n",
"duration_ms": 1686230,
"explicit": true,
"external_urls": {
"published": true,
"spotify": "spotify"
},
"href": "https://api.spotify.com/v1/episodes/5Xt5DXGzch68nYYamXrNxZ",
"html_description": "<p>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.</p>\n",
"images": [
{
"height": 300,
"url": "https://i.scdn.co/image/ab67616d00001e02ff9ca10b55ce82ae553c8228\n",
"width": 300,
"published": true
}
],
"is_playable": true,
"languages": [
"fr",
"en"
],
"name": "Starting Your Own Podcast: Tips, Tricks, and Advice From Anchor Creators\n",
"release_date": "1981-12-15",
"release_date_precision": "day",
"type": "episode",
"uri": "spotify:episode:0zLhl3WsOCQHbe1BPTiHgr",
"available_markets": [
"string"
],
"published": true,
"restrictions": {
"published": true,
"reason": "reason"
},
"resume_point": {
"fully_played": true,
"published": true,
"resume_position_ms": 0
}
}
]
}