Endpoint Playground
Returns Apple Books chart rankings for a `collection`, `top-free` (default) or `top-paid`. Narrow with `genre` (an Apple Books genre ID, `0` for all genres), `country` (default `us`) and `limit` (default 50, max 200). Each entry has `name`, author, `genres`, `release_date`, `artwork_url` and `url`.
14 Oct 2026: 40 items; 9 fields had a value in every checked item.
Sample value profiles: release_date: 1813-01-28 to 2026-10-07; name: “All The Best People Are” and 39 other values; artist_url: books.apple.com.
curl 'https://api.crawlora.net/api/v1/apple-books/charts?collection=top-free' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| collection | string | No | top-free | Chart collection. Allowed values: top-free, top-paid |
| genre | integer | No | Optional Apple Books genre ID to filter the chart | |
| country | string | No | Two-letter storefront country code | |
| limit | integer | No | Number of chart items to return |
{
"code": 200,
"msg": "OK",
"data": [
{
"id": 395540967,
"name": "The Odyssey",
"artist_name": "Homer",
"artist_id": 781333,
"url": "https://books.apple.com/us/book/the-odyssey/id395540967",
"genres": [
"Poetry",
"Books"
]
}
]
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.