---
title: "Search Apple Books audiobooks"
method: GET
path: "/apple-books/audiobook/search"
tags: ["AppleBooks"]
---

# Search Apple Books audiobooks

`GET /apple-books/audiobook/search`

## Request

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

Searches Apple Books audiobooks by `term`, which is required. `country` is the two-letter storefront code (default `us`), `lang` a language tag such as `en-us`, `limit` the result count (default 50, max 200) and `page` starts at 1. Results include `narrator`, `duration_seconds`, price, rating, genres and `preview_url`.

## Query parameters

- `term` string, required
- `country` string
- `lang` string
- `limit` integer
- `page` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ApplebooksAudiobookSearchResponseDoc
  - `code` integer
  - `data` 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.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `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/028417aa35bb?raw)