List Audible audiobook reviews

Try in Playground

List listener reviews for an audiobook with overall, narration and story ratings, sorted by relevance, helpfulness, date or sentiment.

GET/v1/audible/reviewsx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

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

Query parameters

asinstringquery

Audible product ID (ASIN). Send asin or url.

ExampleB002V1OF70

urlstringquery

Audible product URL. Send asin or url.

max 1500 chars

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

sortenumquery

relevant (default), helpful, recent, positive or critical.

one of: relevant, helpful, recent, positive, critical

Examplerecent

pagestringquery

Review page, 1 to 100; defaults to 1.

limitstringquery

Reviews per page, 1 to 50; default 10.

Response fields

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

asinstring

Audible product ID (ASIN). Send asin or url.

titlestring

Audiobook title.

min 1 chars

Listener ratings, or null.

rating.reviewCountnumbernullable

Number of written reviews, or null.

Overall star ratings, or null.

rating.overall.averagenumbernullable

Average rating from 1 to 5, or null.

rating.overall.countnumbernullable

Number of ratings, or null.

rating.overall.fivenumbernullable

Five-star ratings, or null.

rating.overall.fournumbernullable

Four-star ratings, or null.

rating.overall.threenumbernullable

Three-star ratings, or null.

rating.overall.twonumbernullable

Two-star ratings, or null.

rating.overall.onenumbernullable

One-star ratings, or null.

Narration performance star ratings, or null.

rating.performance.averagenumbernullable

Average rating from 1 to 5, or null.

rating.performance.countnumbernullable

Number of ratings, or null.

rating.performance.fivenumbernullable

Five-star ratings, or null.

rating.performance.fournumbernullable

Four-star ratings, or null.

rating.performance.threenumbernullable

Three-star ratings, or null.

rating.performance.twonumbernullable

Two-star ratings, or null.

rating.performance.onenumbernullable

One-star ratings, or null.

Story star ratings, or null.

rating.story.averagenumbernullable

Average rating from 1 to 5, or null.

rating.story.countnumbernullable

Number of ratings, or null.

rating.story.fivenumbernullable

Five-star ratings, or null.

rating.story.fournumbernullable

Four-star ratings, or null.

rating.story.threenumbernullable

Three-star ratings, or null.

rating.story.twonumbernullable

Two-star ratings, or null.

rating.story.onenumbernullable

One-star ratings, or null.

sortenum

relevant (default), helpful, recent, positive or critical.

one of: relevant, helpful, recent, positive, critical

pageinteger

Review page, 1 to 100; defaults to 1.

≥ 1

limitinteger

Reviews per page, 1 to 50; default 10.

1 – 50

hasMoreboolean

Whether a later page may exist (the page was full).

Listener reviews in the requested order.

up to 50 items

reviews.idstring

Always included.

min 1 chars

reviews.titlestringnullable

Always included.

reviews.bodystringnullable

Always included.

reviews.authorNamestringnullable

Always included.

reviews.locationstringnullable

Always included.

reviews.submittedAtstringnullable

Always included.

reviews.overallRatingnumbernullable

Always included.

reviews.performanceRatingnumbernullable

Always included.

reviews.storyRatingnumbernullable

Always included.

reviews.helpfulVotesnumbernullable

Always included.

reviews.unhelpfulVotesnumbernullable

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

HTTP	failure.code	Meaning
200	`partial`	Usable data with named invalid-item, record-limit, total or author-name warnings.
400	`invalid_request`	Missing, duplicate, malformed, unsafe or unsupported parameters.
401	`unauthorized`	Missing or invalid worker API key.
404	`not_found`	The requested audiobook, author or category was not found in the selected store.
422	`unsupported_page`	The Audible response structure or identity could not be mapped.
502	`upstream_challenged`	Audible challenged retrieval.
502	`upstream_rate_limited`	Audible rate-limited retrieval.
502	`upstream_error`	Source retrieval did not complete.
502	`response_too_large`	Source bytes exceeded the request limit.
502	`unsafe_redirect`	Audible answered with a redirect, which is never followed.
502	`request_limit`	The upstream request budget was exhausted.
503	`busy`	Worker request or queue capacity was exceeded.
504	`timeout`	The operation deadline expired.

Code example

curl "https://api.scrapeatlas.com/v1/audible/reviews?asin=B002V1OF70&sort=recent" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/audible/reviews?asin=B002V1OF70&sort=recent",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/audible/reviews?asin=B002V1OF70&sort=recent",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Audible request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/audible/reviews",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "asin": "B002V1OF70",
        "sort": "recent"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/audible/reviews?asin=B002V1OF70&sort=recent", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/audible/reviews?asin=B002V1OF70&sort=recent"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "sourceUrl": "https://www.audible.com/pd/B0EXAMPLE1",
  "fetchedAt": "2026-11-12T00:00:00.000Z",
  "coverage": {
    "source": "public_api",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 14000,
    "durationMs": 420
  },
  "marketplace": "us",
  "asin": "B0EXAMPLE1",
  "title": "The Example Voyage",
  "rating": {
    "reviewCount": 310,
    "overall": {
      "average": 4.6,
      "count": 5200,
      "five": 3900,
      "four": 780,
      "three": 260,
      "two": 156,
      "one": 104
    },
    "performance": {
      "average": 4.7,
      "count": 4800,
      "five": 3600,
      "four": 720,
      "three": 240,
      "two": 144,
      "one": 96
    },
    "story": {
      "average": 4.5,
      "count": 4790,
      "five": 3592,
      "four": 718,
      "three": 239,
      "two": 143,
      "one": 98
    }
  },
  "sort": "recent",
  "page": 1,
  "limit": 10,
  "hasMore": true,
  "reviews": [
    {
      "id": "a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "title": "Wonderful narration",
      "body": "The narrator gives every character a distinct voice.",
      "authorName": "Example Listener",
      "location": null,
      "submittedAt": "2026-11-01T10:00:00Z",
      "overallRating": 5,
      "performanceRating": 5,
      "storyRating": 4,
      "helpfulVotes": 12,
      "unhelpfulVotes": 1
    }
  ]
}

Missing, duplicate, malformed, unsafe or unsupported parameters.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}