Endpoint Playground

Try the Facet the Apple Books dataset API

Returns term counts over the same filters as search. Facet values: `kind`, `genres`, `artist_name`, `publisher`, `series_name`, `narrator`, `provider`, `currency`, `discovery_country`, `discovery_source`, `free`. Dataset Playground requests query indexed data and do not apply proxy routing.

What a live request returned

31 Oct 2026: 5 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/apple-books/facets?facet=kind
Fields with a value in every checked item: count, value

Request: GET /datasets/apple-books/facets
Cost: 1 credit/request
Auth: apiKey

Facet the Apple Books dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/apple-books/facets?facet=kind&kind=book' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	kind	Facet: kind, genres, artist_name, publisher, series_name, narrator, provider, currency, discovery_country, discovery_source, free
q	string	No		Full-text query over name, artist, series, narrator and description; max 256 characters
kind	string	No	book	Record kind: book, audiobook, author, series, audiobook_series
genre	string	No		Exact Apple Books genre label, max 128 characters
artist	string	No		Exact author or artist name, max 128 characters
artist_id	string	No		Exact numeric Apple Books artist ID, max 128 characters
publisher	string	No		Exact ebook publisher, max 128 characters
series	string	No		Exact series name, max 128 characters
narrator	string	No		Exact audiobook narrator, max 128 characters
provider	string	No		Exact audiobook provider, max 128 characters
currency	string	No		Exact currency code, max 128 characters
country	string	No		Exact discovery storefront country, max 128 characters
discovery_source	string	No		Exact crawl source, max 128 characters
free	boolean	No		Filter for free titles
min_rating	number	No		Minimum average rating from 0 through 5
min_rating_count	integer	No		Minimum rating count, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apple-books",
    "facet": "kind",
    "items": [
      {
        "value": "audiobook",
        "count": 609767
      }
    ]
  }
}

More Datasets endpoints

List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset Get an Apple Books record Search Apple Books records Facet stored Apple Maps places Get a stored Apple Maps place Find nearby stored Apple Maps places Search stored Apple Maps places Facet Apple Podcasts shows dataset All 165 Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.appleBooksFacetResponseDocDatasets

GET /datasets/apple-books/facets

Discover Apple Books dataset values

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Facet: kind, genres, artist_name, publisher, series_name, narrator, provider, currency, discovery_country, discovery_source, free · allowed: kind, genres, artist_name, publisher, series_name, narrator, provider, currency, discovery_country, discovery_source, free

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

datasets_apple_books_facets

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apple-books",
    "facet": "kind",
    "items": [
      {
        "value": "audiobook",
        "count": 609767
      }
    ]
  }
}

Endpoint Playground

Try the Facet the Apple Books dataset API

What a live request returned

31 Oct 2026: 5 items; 2 fields had a value in every checked item.

Observed request: GET /datasets/apple-books/facets?facet=kind
Fields with a value in every checked item: count, value

Request: GET /datasets/apple-books/facets
Cost: 1 credit/request
Auth: apiKey

Facet the Apple Books dataset API documentation Datasets platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/datasets/apple-books/facets?facet=kind&kind=book' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
facet	string	Yes	kind	Facet: kind, genres, artist_name, publisher, series_name, narrator, provider, currency, discovery_country, discovery_source, free
q	string	No		Full-text query over name, artist, series, narrator and description; max 256 characters
kind	string	No	book	Record kind: book, audiobook, author, series, audiobook_series
genre	string	No		Exact Apple Books genre label, max 128 characters
artist	string	No		Exact author or artist name, max 128 characters
artist_id	string	No		Exact numeric Apple Books artist ID, max 128 characters
publisher	string	No		Exact ebook publisher, max 128 characters
series	string	No		Exact series name, max 128 characters
narrator	string	No		Exact audiobook narrator, max 128 characters
provider	string	No		Exact audiobook provider, max 128 characters
currency	string	No		Exact currency code, max 128 characters
country	string	No		Exact discovery storefront country, max 128 characters
discovery_source	string	No		Exact crawl source, max 128 characters
free	boolean	No		Filter for free titles
min_rating	number	No		Minimum average rating from 0 through 5
min_rating_count	integer	No		Minimum rating count, 0 or greater

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apple-books",
    "facet": "kind",
    "items": [
      {
        "value": "audiobook",
        "count": 609767
      }
    ]
  }
}

More Datasets endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.appleBooksFacetResponseDocDatasets

GET /datasets/apple-books/facets

Discover Apple Books dataset values

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

facet

requiredstring

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

MCP tool

MCP URL

https://mcp.crawlora.net/mcp

Tool name

datasets_apple_books_facets

MCP auth

Authorization: Bearer $CRAWLORA_API_KEY

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "dataset": "apple-books",
    "facet": "kind",
    "items": [
      {
        "value": "audiobook",
        "count": 609767
      }
    ]
  }
}