apple_books_charts
Fetch Apple Books ebook chart rankings by top-free or top-paid collection, with optional genre, country, and result limit filters. Returns title, author, genres, release date, artwork, and URL data.
Instructions
Retrieve Apple Books chart rankings. Returns Apple Books ebook chart rankings for collection, top-free (default) or top-paid. Omit genre for all genres, or use one of the discovered ebook category IDs. country defaults to us; limit defaults to 50 and maxes at 200. Each entry has name, author, genres, release_date, artwork_url and url.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "apple_books_charts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| genre | No | Optional ebook genre ID. Allowed values: 9008, 9009, 9026, 9027, 9028, 9031, 9025, 9015, 11086, 9032, 9002, 9034, 9018, 9003, 9020, 9035, 11165. Use apple_books_genres with media=book to discover names. | |
| limit | No | Number of chart items to return | |
| country | No | Two-letter storefront country code | |
| collection | No | Chart collection. Allowed values: top-free, top-paid |