---
title: "Retrieve an Apple Books audiobook series and its full audiobook list"
method: GET
path: "/apple-books/audiobook-series/{id}"
tags: ["AppleBooks"]
---

# Retrieve an Apple Books audiobook series and its full audiobook list

`GET /apple-books/audiobook-series/{id}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/apple-books/audiobook-series/{id}`
- Auth: API key in header `x-api-key`

Returns series metadata and the full ordered list of audiobooks in the series from Apple Books' public catalog page. An audio-book-series is a catalog resource distinct from a book-series, even for the same conceptual series.

## Path parameters

- `id` string, required

## Query parameters

- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplebooksAudiobookSeriesResponseDoc
  - `code` integer
  - `data` ApplebooksAudiobookSeries
    - `audiobooks` ApplebooksAudiobook[]
      - `artist_id` integer: Apple Books id of the author.
      - `artist_name` string: Name of the author as Apple Books lists it.
      - `artist_url` string: Apple Books page URL of the author.
      - `artwork_url` string: URL of the audiobook cover artwork.
      - `book_id` integer: Apple Books id of the matching ebook edition, when one exists.
      - `currency` string: Currency code of `price`, such as `USD`.
      - `description` string: Audiobook description as shown on Apple Books.
      - `duration_seconds` integer: Length of the audiobook, in seconds.
      - `free` boolean: Whether the audiobook is free, meaning its price is 0.
      - `genres` string[]: Genres Apple Books files the audiobook under.
      - `id` integer: Apple Books audiobook id.
      - `name` string: Title of the audiobook as Apple Books shows it.
      - `narrator` string: Name of the narrator.
      - `preview_url` string: URL of an audio preview sample.
      - `price` number: Audiobook price in the currency given by `currency`.
      - `provider` string: Publisher or provider Apple Books credits for the audiobook.
      - `rating` number: Average customer rating of the audiobook.
      - `rating_count` integer: Number of customer ratings the audiobook has received.
      - `rating_histogram` object: Number of ratings for each star value, keyed `1` to `5`.
      - `release_date` string: Release date of the audiobook, in ISO 8601 format.
      - `series_id` integer: Apple Books id of the series the audiobook belongs to.
      - `series_name` string: Name of the series the audiobook belongs to.
      - `url` string: Apple Books page URL of the audiobook.
    - `id` integer
    - `name` string
    - `url` string
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `404`: Series not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[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/afac9b012a27?raw)