Get Amazon product reviews

Try in Playground

Read the customer reviews embedded in the public product page (typically the top reviews, about eight). Each row carries id, title, text, stars, author, verified flag, helpful votes, images and the review date. Sibling variants can contribute reviews; entity_id is always the requested ASIN. Up to five equivalent mobile and desktop views are read to collect the embedded list; reviews_not_embedded marks a response whose page views carried none.

GET/v1/amazon/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

asinstringrequiredquery

10-character ASIN.

ExampleB000000001

countryenumdefault: "US"query

Marketplace as ISO 3166-1 alpha-2: US (default), GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU or NL. Prices come in that marketplace's currency and numbers are parsed with its locale.

one of: US, GB, CA, DE, FR, IT, ES, JP, IN, MX, BR, AU, NL · default: "US"

Response fields

requestIdstring

Random operational correlation ID.

Upstream attempts, decoded HTML bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.amazon.com URL that was read.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded page had no known omissions; warnings name each omission.

coverage.sourcestring

Always public_page.

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable omission codes such as lazy_loaded_ranks_omitted or record_limit.

Review rows in page order.

up to 100 items

Canonical review object.

items.review.idstring

Amazon review id.

items.review.entity_idstring

Requested ASIN.

items.review.urlstring

Public review URL.

absolute HTTPS URL

items.review.titlestringnullable

Review title.

items.review.textstringnullable

Full review text.

Stars (value) out of max 5.

items.review.rating.valuenumbernullable

Always included.

items.review.rating.maxnumber

Always included.

Reviewer name, avatar, profile URL and country; reviews_count is null.

items.review.author.namestringnullable

Always included.

items.review.author.avatar_urlstringnullable

Always included.

items.review.author.urlstringnullable

Always included.

items.review.author.locationstringnullable

Always included.

items.review.author.reviews_countintegernullable

Always included.

items.review.helpful_votesintegernullable

Helpful votes when shown.

items.review.verifiedbooleannullable

Verified Purchase badge.

items.review.sourcestringnullable

Always included.

items.review.languagestringnullable

Always included.

items.review.original_languagestringnullable

Always included.

items.review.translatedbooleannullable

Always included.

items.review.imagesstring[]nullable

Attached image URLs or null.

items.review.responsesobject[]nullable

Always included.

items.review.published_atstringnullable

Review date as ISO 8601 UTC midnight.

totalintegernullable

Total matching count when the page states one; otherwise null.

droppedinteger

Cards that could not be parsed into a record.

≥ 0

Cursor state for this page.

pagination.next_cursorstringnullable

Page number to send back as cursor, or null on the last page.

pagination.has_moreboolean

Whether another page exists.

pagination.page_sizeinteger

Number of items in this page.

≥ 0

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
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Storefront, product, category or seller page not found.
429	`upstream_rate_limited`	Amazon rate limited the request; no automatic retry.
502	`upstream_challenged`	Robot check, sign-in wall or HTTP 503 from Amazon.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `payload_too_complex` `request_limit` `upstream_error`	Bounded retrieval failed or the page did not match the requested entity.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as lazy_loaded_ranks_omitted or record_limit.

Code example

curl "https://api.scrapeatlas.com/v1/amazon/reviews?asin=B000000001" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/amazon/reviews?asin=B000000001",
  {
    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/amazon/reviews?asin=B000000001",
  {
    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(`Amazon request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/amazon/reviews",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "asin": "B000000001"
    },
    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/amazon/reviews?asin=B000000001", 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/amazon/reviews?asin=B000000001"))
            .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.amazon.com/dp/B000000001",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 1,
    "responseBytes": 140000,
    "durationMs": 620
  },
  "items": [
    {
      "review": {
        "id": "R000000000001",
        "entity_id": "B000000001",
        "url": "https://www.amazon.com/gp/customer-reviews/R000000000001",
        "title": "Works great",
        "text": "Synthetic review body.",
        "rating": {
          "value": 5,
          "max": 5
        },
        "author": {
          "name": "Synthetic Customer",
          "avatar_url": "https://m.media-amazon.com/images/S/amazon-avatars-global/default._SX110_.png",
          "url": "https://www.amazon.com/gp/profile/amzn1.account.SYNTHETIC",
          "location": "US",
          "reviews_count": null
        },
        "helpful_votes": 1,
        "verified": true,
        "source": null,
        "language": null,
        "original_language": null,
        "translated": null,
        "images": null,
        "responses": null,
        "published_at": "2026-07-31T00:00:00.000Z"
      }
    }
  ],
  "total": null,
  "dropped": 0,
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  }
}

Missing, duplicate, unsupported or invalid 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."
  }
}