Skip to content
scrapeatlas.Dashboard

Search Audible audiobooks

Try in Playground

Search the Audible catalog by keyword, author, narrator or category, sorted by relevance, sales, date, rating, title or length.

GET/v1/audible/searchx-api-key
x-api-keystringrequiredheader

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

Query parameters
8
querystringquery

Search keywords, 1 to 200 characters.

min 1 chars · max 200 chars

Exampledune
authorstringquery

Author name to filter by, 1 to 200 characters.

min 1 chars · max 200 chars

narratorstringquery

Narrator name to filter by, 1 to 200 characters.

min 1 chars · max 200 chars

categoryIdstringquery

Category ID from Audible categories or a book's categories.

sortenumquery

relevance (default), bestsellers, newest, oldest, rating, title, longest or shortest.

one of: relevance, bestsellers, newest, oldest, rating, title, longest, shortest

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
78
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

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.

Matching titles in the requested 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.

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.