Search + K

Command Palette

Search for a command to run...

Sign In

Get an Audiobook

GET /audiobooks/{id}
Copy endpoint
https://api.spotify.com/v1

Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Parameters

path Path Parameters

Name Type
id required
string

query Query Parameters

Name Type
market
string

Responses

200 application/json

An Audiobook

type AudiobookObject = interface AudiobookBase {
authors: AuthorObject
interface AuthorObject {
name?: string;
}
[]
;
available_markets: string[];
copyrights: CopyrightObject
interface CopyrightObject {
text?: string;
type?: string;
}
[]
;
description: string;
html_description: string;
edition?: string;
explicit: boolean;
external_urls: ExternalUrlObject
interface ExternalUrlObject {
spotify?: string;
}
;
href: string;
id: string;
images: ImageObject
interface ImageObject {
url: string;
height: number | null;
width: number | null;
}
[]
;
languages: string[];
media_type: string;
name: string;
narrators: NarratorObject
interface NarratorObject {
name?: string;
}
[]
;
publisher: string;
type: "audiobook";
uri: string;
total_chapters: number;
}
& { chapters: {} & PagingSimplifiedChapterObject
type PagingSimplifiedChapterObject = never
; }

Client Errors

400 application/json

The request contains malformed data in path, query parameters, or body.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
404 application/json

The requested resource cannot be found.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
429 application/json

The app has exceeded its rate limits.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }