---
title: "Retrieve Spotify audiobook details"
method: GET
path: "/spotify/audiobook"
tags: ["Spotify"]
---

# Retrieve Spotify audiobook details

`GET /spotify/audiobook`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/spotify/audiobook`
- Auth: API key in header `x-api-key`

Returns a Spotify audiobook by `uri` or `id`; Spotify identifies audiobooks with show URIs (`spotify:show:...`). The response has name, authors, narrators, publisher, description, `totalChapters`, explicit flag and cover images. Passing a podcast show instead of an audiobook returns an upstream error, and an invalid identifier returns 400.

## Query parameters

- `uri` string
- `id` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- SpotifyAudiobookResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` SpotifyAudiobookResponse
    - `authors` string[]: Names of the audiobook's authors.
    - `description` string: Description text of the audiobook.
    - `externalUrl` string: Link to the audiobook on open.spotify.com.
    - `id` string: Spotify ID of the audiobook.
    - `imageUrl` string: URL of the audiobook cover image.
    - `images` SpotifyImageAsset[]: Cover images available for the audiobook, with their sizes.
      - `height` integer: Image height in pixels.
      - `url` string: URL of the image.
      - `width` integer: Image width in pixels.
    - `isExplicit` boolean: Whether Spotify marks the audiobook as explicit.
    - `mediaType` string: Kind of media the audiobook carries, as Spotify labels it.
    - `meta` SpotifyAudiobookMeta
      - `appVersion` string: Version of the Spotify web player the data was read from.
      - `fetchedAt` string: Time the data was fetched, in UTC (RFC 3339).
      - `operationName` string: Name of the Spotify web player operation that returned the data.
    - `name` string: Audiobook title as Spotify shows it.
    - `narrators` string[]: Names of the audiobook's narrators.
    - `publisher` string: Name of the audiobook's publisher.
    - `totalChapters` integer: Total number of chapters in the audiobook.
    - `type` string: Kind of item as Spotify labels it, for example `Audiobook`.
    - `uri` string: Spotify URI of the audiobook.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)