> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapeunblocker.com/llms.txt > Use this file to discover all available pages before exploring further. # Scrape the reviews on an Amazon product page > Returns the customer reviews Amazon embeds on a product page as JSON: the overall `rating`, total `reviewCount`, the 5..1-star `histogram`, and the recent top `reviews` (each with `author`, `rating`, `title`, `body`, `date`, `country`, `verified`, `helpfulVotes`, `variant` and `images`). Identify the product with either `asin` (plus `marketplace`) or a full product `url`. Scope: Amazon shows only a handful of top reviews (about 8) to logged-out visitors on the product page, and gates the full review history behind sign-in, so this endpoint returns the rating breakdown plus those recent reviews - a useful sample, not a complete review export. `proxy_country` defaults to the marketplace's home country so reviews come from the expected regional store; the exit that served the request is returned as `exitCountry` / `exitProvider`. ## OpenAPI ````yaml /api-reference/openapi.json post /marketplace/amazon-reviews openapi: 3.1.0 info: title: ScrapeUnblocker API description: >- Public API for the ScrapeUnblocker proxy/anti-bot service. Authenticate every request with the `x-scrapeunblocker-key` header. Three endpoints are documented here: page-source extraction, Google SERP scraping, and image fetch. All other paths exist for internal operations and are intentionally hidden from this spec. version: 3.0.0 servers: - url: https://api.scrapeunblocker.com description: Production security: [] paths: /marketplace/amazon-reviews: post: tags: - Plugins summary: Scrape the reviews on an Amazon product page description: >- Returns the customer reviews Amazon embeds on a product page as JSON: the overall `rating`, total `reviewCount`, the 5..1-star `histogram`, and the recent top `reviews` (each with `author`, `rating`, `title`, `body`, `date`, `country`, `verified`, `helpfulVotes`, `variant` and `images`). Identify the product with either `asin` (plus `marketplace`) or a full product `url`. Scope: Amazon shows only a handful of top reviews (about 8) to logged-out visitors on the product page, and gates the full review history behind sign-in, so this endpoint returns the rating breakdown plus those recent reviews - a useful sample, not a complete review export. `proxy_country` defaults to the marketplace's home country so reviews come from the expected regional store; the exit that served the request is returned as `exitCountry` / `exitProvider`. operationId: amazon_reviews_marketplace_amazon_reviews_post parameters: - name: asin in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Amazon product id (10-char ASIN, e.g. 'B08N5WRWNW'). Give either `asin` (with `marketplace`) or a full product `url`. title: Asin description: >- Amazon product id (10-char ASIN, e.g. 'B08N5WRWNW'). Give either `asin` (with `marketplace`) or a full product `url`. - name: url in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Full Amazon product url, e.g. 'https://www.amazon.de/dp/B08N5WRWNW'. The ASIN and marketplace are read from it, so `asin`/`marketplace` are not needed when a url is given. title: Url description: >- Full Amazon product url, e.g. 'https://www.amazon.de/dp/B08N5WRWNW'. The ASIN and marketplace are read from it, so `asin`/`marketplace` are not needed when a url is given. - name: marketplace in: query required: false schema: type: string description: >- Regional Amazon site the ASIN belongs to. Reviews are read from that store. One of: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx, amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa, amazon.sg, amazon.com.au. default: amazon.com title: Marketplace description: >- Regional Amazon site the ASIN belongs to. Reviews are read from that store. One of: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx, amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa, amazon.sg, amazon.com.au. - name: proxy_country in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Defaults to the marketplace's home country; routed through the Oxylabs ISP + iProyal ISP pool. title: Proxy Country description: >- Exit-IP country (ISO-2, e.g. 'US', 'DE'). Defaults to the marketplace's home country; routed through the Oxylabs ISP + iProyal ISP pool. responses: '200': description: Product found; rating, histogram and embedded reviews parsed. content: application/json: schema: {} '400': description: No/invalid ASIN or url, or unsupported marketplace. '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '502': description: Blocked by Amazon or the product page could not be fetched. '504': description: Fetch timed out. security: - ScrapeUnblockerKey: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: ScrapeUnblockerKey: type: apiKey in: header name: x-scrapeunblocker-key description: Your ScrapeUnblocker API key. Apply on every request. ````