Skip to content
scrapeatlas.Dashboard

List Audible best sellers

Try in Playground

List Audible's best-selling audiobooks for a store or category with their rank, ratings, length and price.

GET/v1/audible/best-sellersx-api-key
x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters
4
categoryIdstringquery

Category ID to rank within; omit for the whole store.

marketplaceenumquery

Audible store: us (default), uk, ca, au, in, de, fr, it, es or jp. A URL sets the store from its domain.

one of: us, uk, ca, au, in, de, fr, it, es, jp

pagestringquery

Result page, 1 to 100; defaults to 1.

limitstringquery

Results per page, 1 to 50; default 20.

Example20
Response fields
80
requestIdstring

Request correlation UUID.

Retrieval attempt, source byte and timing measurements.

accounting.upstreamRequestsinteger

Upstream request attempts, including any retry.

≥ 0

accounting.responseBytesinteger

Source bytes read during this request.

≥ 0

accounting.durationMsnumber

Elapsed operation time in milliseconds.

≥ 0

successboolean

True when usable data is returned; inspect status and coverage.

statusenum

success or partial for usable data; failed or challenged for a failure.

one of: success, partial

sourceUrlstring

Public Audible page the data describes.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Returned-page coverage and mapping warnings.

coverage.sourcestring

Audible's public catalog API.

coverage.completeboolean

Whether every supported field on this page was mapped without a reported omission.

coverage.warningsenum[]

Named warnings: invalid_item (a record without required fields was skipped), record_limit (a list was capped), total_unavailable (no result count) or author_name_match (titles by another author with the same name were removed).

marketplaceenum

Audible store: us (default), uk, ca, au, in, de, fr, it, es or jp. A URL sets the store from its domain.

one of: us, uk, ca, au, in, de, fr, it, es, jp

categoryIdstringnullable

Category ID to rank within; omit for the whole store.

pageinteger

Result page, 1 to 100; defaults to 1.

≥ 1

limitinteger

Results per page, 1 to 50; default 20.

1 – 50

totalintegernullable

Total matches reported by Audible, or null.

≥ 0

hasMoreboolean

Whether a later page exists.

Titles in best-seller order.

up to 50 items

results.asinstring

Always included.

results.titlestring

Always included.

min 1 chars

results.subtitlestringnullable

Always included.

results.urlstring

Always included.

absolute HTTPS URL

Always included.

up to 50 items

results.authors.asinstringnullable

Always included.

results.authors.namestring

Always included.

min 1 chars

Always included.

up to 50 items

results.narrators.asinstringnullable

Always included.

results.narrators.namestring

Always included.

min 1 chars

results.publisherstringnullable

Always included.

results.releaseDatestringnullable

Always included.

results.languagestringnullable

Always included.

results.runtimeMinutesnumbernullable

Always included.

results.formatTypestringnullable

Always included.

results.contentTypestringnullable

Always included.

results.contentDeliveryTypestringnullable

Always included.

results.isAdultbooleannullable

Always included.

results.summarystringnullable

Always included.

results.coverUrlstringnullable

Always included.

Always included.

results.rating.reviewCountnumbernullable

Always included.

Always included.

results.rating.overall.averagenumbernullable

Always included.

results.rating.overall.countnumbernullable

Always included.

results.rating.overall.fivenumbernullable

Always included.

results.rating.overall.fournumbernullable

Always included.

results.rating.overall.threenumbernullable

Always included.

results.rating.overall.twonumbernullable

Always included.

results.rating.overall.onenumbernullable

Always included.

Always included.

results.rating.performance.averagenumbernullable

Always included.

results.rating.performance.countnumbernullable

Always included.

results.rating.performance.fivenumbernullable

Always included.

results.rating.performance.fournumbernullable

Always included.

results.rating.performance.threenumbernullable

Always included.

results.rating.performance.twonumbernullable

Always included.

results.rating.performance.onenumbernullable

Always included.

Always included.

results.rating.story.averagenumbernullable

Always included.

results.rating.story.countnumbernullable

Always included.

results.rating.story.fivenumbernullable

Always included.

results.rating.story.fournumbernullable

Always included.

results.rating.story.threenumbernullable

Always included.

results.rating.story.twonumbernullable

Always included.

results.rating.story.onenumbernullable

Always included.

Always included.

up to 20 items

results.series.asinstringnullable

Always included.

results.series.titlestring

Always included.

min 1 chars

results.series.sequencestringnullable

Always included.

results.series.urlstringnullable

Always included.

Always included.

up to 20 items

results.categories.idstring

Always included.

min 1 chars

results.categories.namestring

Always included.

min 1 chars

Always included.

results.price.listPricenumbernullable

Always included.

results.price.lowestPricenumbernullable

Always included.

results.price.currencystringnullable

Always included.

results.price.creditPricenumbernullable

Always included.

results.rankinteger

Always included.

≥ 1

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes
13
HTTPfailure.codeMeaning
200partialUsable data with named invalid-item, record-limit, total or author-name warnings.
400invalid_requestMissing, duplicate, malformed, unsafe or unsupported parameters.
401unauthorizedMissing or invalid worker API key.
404not_foundThe requested audiobook, author or category was not found in the selected store.
422unsupported_pageThe Audible response structure or identity could not be mapped.
502upstream_challengedAudible challenged retrieval.
502upstream_rate_limitedAudible rate-limited retrieval.
502upstream_errorSource retrieval did not complete.
502response_too_largeSource bytes exceeded the request limit.
502unsafe_redirectAudible answered with a redirect, which is never followed.
502request_limitThe upstream request budget was exhausted.
503busyWorker request or queue capacity was exceeded.
504timeoutThe operation deadline expired.