Datasets API endpoint
Returns one named, publicly usable ebook, audiobook, author, or series record by its resource kind and numeric ID. Kind values: `book`, `audiobook`, `author`, `series`, `audiobook_series`. Internal crawl errors and unavailable placeholders are not returned.
/datasets/apple-books/items/{kind}/{id}MCP tool: datasets_apple_books_item
Returns one named public catalog record already stored in the dataset. kind
is required and is one of book, audiobook, author, series,
audiobook_series. id is the corresponding numeric Apple Books ID. The
response preserves resource-specific fields, such as ISBN and page count for
ebooks or narrator and duration for audiobooks. Unavailable placeholders and
internal enrichment errors are not returned. An unknown or unavailable item
returns 404.
| Field | In the sample |
|---|---|
| artist_id | Has a value |
| artist_name | Has a value |
| artist_url | Has a value |
| artwork_url | Has a value |
| book_id | Has a value |
| crawled_at | Has a value |
| currency | Has a value |
| description | Has a value |
| discovery_country | Has a value |
| discovery_source | Has a value |
| duration_seconds | Has a value |
| free | Has a value |
| genres | Has a value |
| id | Has a value |
| kind | Has a value |
| name | Has a value |
| narrator | Has a value |
| preview_url | Has a value |
| price | Has a value |
| provider | Has a value |
| rating | Has a value |
| rating_count | Has a value |
| rating_histogram | Has a value |
| release_date | Has a value |
| url | Has a value |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| kind (path) | string | Yes | Resource kind: book, audiobook, author, series, audiobook_series Allowed values: book, audiobook, author, series, audiobook_series. | book | |
| id (path) | string | Yes | Numeric Apple Books resource ID | 1037193578 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/datasets/apple-books/items/book/1037193578" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": "1882772196",
"kind": "audiobook",
"name": "Example Audiobook",
"artist_name": "Example Author",
"duration_seconds": 43200
}
}Request schema
No body schema
Response schema
#/definitions/datasets.appleBooksItemResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | datasets.AppleBooksDatasetItem | No | ||||
| data.artist_id | integer | No | ||||
| data.artist_name | string | No | ||||
| data.artist_url | string | No | ||||
| data.artwork_url | string | No | ||||
| data.audience | string | No | ||||
| data.audiobook_id | integer | No | ||||
| data.audiobook_ids | array | No | ||||
| data.book_id | integer | No | ||||
| data.book_ids | array | No | ||||
| data.crawled_at | string | No | ||||
| data.currency | string | No | ||||
| data.description | string | No | ||||
| data.discovery_country | string | No | ||||
| data.discovery_source | string | No | ||||
| data.duration_seconds | integer | No | ||||
| data.free | boolean | No | ||||
| data.genres | array | No | ||||
| data.id | string | No | ||||
| data.isbn | string | No | ||||
| data.kind | string | No | book, audiobook, author, series, audiobook_series | |||
| data.name | string | No | ||||
| data.narrator | string | No | ||||
| data.page_count | integer | No | ||||
| data.preview_url | string | No | ||||
| data.price | number | No | ||||
| data.provider | string | No | ||||
| data.publisher | string | No | ||||
| data.rating | number | No | ||||
| data.rating_count | integer | No | ||||
| data.rating_histogram | object | No | ||||
| data.related_item_count | integer | No | ||||
| data.release_date | string | No | ||||
| data.series_id | integer | No | ||||
| data.series_name | string | No | ||||
| data.series_sequence | string | No | ||||
| data.url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/datasets/apple-books/items/book/1037193578" \
-H "x-api-key: $CRAWLORA_API_KEY"