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

# Retrieve an Apple Books series and its full book list

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

## Request

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

Returns an Apple Books series by its numeric `id`: the series `name` and `url`, and its books in series order. Each book has `series_sequence`, author, `publisher`, `isbn`, `page_count`, price and rating. `country` (default `us`) and `lang` choose the storefront and language.

## Path parameters

- `id` string, required

## Query parameters

- `country` string
- `lang` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplebooksSeriesResponseDoc
  - `code` integer
  - `data` ApplebooksSeries
    - `books` ApplebooksBook[]
      - `artist_id` integer
      - `artist_name` string
      - `artist_url` string
      - `artwork_url` string
      - `audience` string
      - `audiobook_id` integer
      - `currency` string
      - `description` string
      - `free` boolean
      - `genres` string[]
      - `id` integer
      - `isbn` string
      - `name` string
      - `page_count` integer
      - `price` number
      - `publisher` string
      - `rating` number
      - `rating_count` integer
      - `rating_histogram` object
      - `release_date` string
      - `series_id` integer
      - `series_name` string
      - `series_sequence` string
      - `url` string
    - `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)