Audible API endpoint
Returns an Audible audiobook: description, authors, narrators, series, category ladders, publisher, release date, runtime, language, sample audio URL, rating (overall/performance/story), and public list price.
/audible/product/{asin}Returns an Audible audiobook.
Path parameters:
asin (required) — Audible ASIN, e.g. B08G9PRS1K.Response includes subtitle, description, authors[]/narrators[] (asin, name), series[] (asin, title, sequence, uri), categories[] (root, path[] of id/name), publisher, release_date, runtime_minutes, language, format_type, image_url, sample_url, rating (num_reviews, overall/performance/story each with average, display_average, num_ratings, five_star…one_star), and price (credit_price, list_price, currency_code). An unknown ASIN returns 404 — Audible's own API answers it with a soft-404 (HTTP 200 with only the ASIN echoed back), which this endpoint classifies as not-found rather than passing through.
| Field | Filled in, of 1 checked | Values in the sample |
|---|---|---|
| asin | 1 | |
| name | 1 | “Andy Weir” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| asin (path) | string | Yes | Audible ASIN | B08G9PRS1K | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/audible/product/B08G9PRS1K" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"asin": "B08G9PRS1K",
"title": "Project Hail Mary",
"description": "A lone astronaut must save the earth from disaster in this incredible new science-based thriller from the number-one New York Times best-selling author of The Martian.",
"authors": [
{
"asin": "B00G0WYW92",
"name": "Andy Weir"
}
],
"narrators": [
{
"name": "Ray Porter"
}
],
"categories": [
{
"root": "Genres",
"path": [
{
"id": "18580606011",
"name": "Science Fiction & Fantasy"
},
{
"id": "18580628011",
"name": "Science Fiction"
},
{
"id": "18580645011",
"name": "Space Opera"
}
]
}
],
"publisher": "Audible Studios",
"release_date": "2021-05-04",
"runtime_minutes": 970,
"language": "english",
"format_type": "unabridged",
"image_url": "https://m.media-amazon.com/images/I/51POf8gOyLL._SL500_.jpg",
"sample_url": "https://samples.audible.com/bk/adbl/051843/bk_adbl_051843_sample.mp3",
"rating": {
"num_reviews": 47436,
"overall": {
"average": 4.87,
"display_average": "4.9",
"num_ratings": 309353,
"five_star": 278824,
"four_star": 24681,
"three_star": 4072,
"two_star": 1108,
"one_star": 668
}
},
"price": {
"credit_price": 1,
"list_price": 25.22,
"currency_code": "USD"
},
"uri": "https://www.audible.com/pd/B08G9PRS1K",
"source_url": "https://api.audible.com/1.0/catalog/products/B08G9PRS1K?response_groups=product_desc,product_attrs,media,contributors,category_ladders,series,rating,price,sample"
}
}Request schema
No body schema
Response schema
#/definitions/audible.productResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | audible.ProductResponse | No | ||||
| data.asin | string | No | B08G9PRS1K | |||
| data.authors | array | No | ||||
| data.authors[].asin | string | No | ||||
| data.authors[].name | string | No | ||||
| data.categories | array | No | ||||
| data.categories[].path | array | No | ||||
| data.categories[].path[].id | string | No | ||||
| data.categories[].path[].name | string | No | ||||
| data.categories[].root | string | No | ||||
| data.description | string | No | ||||
| data.format_type | string | No | unabridged | |||
| data.image_url | string | No | ||||
| data.is_preorderable | boolean | No | IsPreorderable and ProductState are what actually distinguishes a "coming soon" preorder title from an already-released one — there is no upstream query filter for this, see SearchResult's doc comment. | |||
| data.language | string | No | ||||
| data.narrators | array | No | ||||
| data.narrators[].asin | string | No | ||||
| data.narrators[].name | string | No | ||||
| data.price | audible.Price | No | ||||
| data.price.credit_price | number | No | ||||
| data.price.currency_code | string | No | ||||
| data.price.list_price | number | No | ||||
| data.product_state | string | No | AVAILABLE_FOR_PREORDER | |||
| data.publisher | string | No | ||||
| data.rating | audible.Rating | No | ||||
| data.rating.num_reviews | integer | No | ||||
| data.rating.overall | audible.RatingDistribution | No | ||||
| data.rating.overall.average | number | No | 4.87 | |||
| data.rating.overall.display_average | string | No | 4.9 | |||
| data.rating.overall.five_star | integer | No | ||||
| data.rating.overall.four_star | integer | No | ||||
| data.rating.overall.num_ratings | integer | No | ||||
| data.rating.overall.one_star | integer | No | ||||
| data.rating.overall.three_star | integer | No | ||||
| data.rating.overall.two_star | integer | No | ||||
| data.rating.performance | audible.RatingDistribution | No | ||||
| data.rating.performance.average | number | No | 4.87 | |||
| data.rating.performance.display_average | string | No | 4.9 | |||
| data.rating.performance.five_star | integer | No | ||||
| data.rating.performance.four_star | integer | No | ||||
| data.rating.performance.num_ratings | integer | No | ||||
| data.rating.performance.one_star | integer | No | ||||
| data.rating.performance.three_star | integer | No | ||||
| data.rating.performance.two_star | integer | No | ||||
| data.rating.story | audible.RatingDistribution | No | ||||
| data.rating.story.average | number | No | 4.87 | |||
| data.rating.story.display_average | string | No | 4.9 | |||
| data.rating.story.five_star | integer | No | ||||
| data.rating.story.four_star | integer | No | ||||
| data.rating.story.num_ratings | integer | No | ||||
| data.rating.story.one_star | integer | No | ||||
| data.rating.story.three_star | integer | No | ||||
| data.rating.story.two_star | integer | No | ||||
| data.release_date | string | No | 2021-05-04 | |||
| data.runtime_minutes | integer | No | ||||
| data.sample_url | string | No | ||||
| data.series | array | No | ||||
| data.series[].asin | string | No | ||||
| data.series[].sequence | string | No | ||||
| data.series[].title | string | No | ||||
| data.series[].uri | string | No | ||||
| data.source_url | string | No | ||||
| data.subtitle | string | No | ||||
| data.title | string | No | Project Hail Mary | |||
| data.uri | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/audible/product/B08G9PRS1K" \
-H "x-api-key: $CRAWLORA_API_KEY"