Amazon Product Review is used to fetch Amazon product review data.

• Fetch reviews by product URL
• Support region-based requests
• Return review text, rating, author information, and review metadata
• Accept multiple product URLs in one request

Use XCrawl to Fetch Amazon Product Reviews

Usage

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "amazon_product_review",
    "location": "US",
    "product_url_list": ["xxxxx"]
  }'

Request parameter notes:

• engine must be amazon_product_review
• location specifies the target region
• product_url_list accepts one or more product URLs

Response Example

{
  "result": [
    {
      "url": "https://www.amazon.com/Unisex-Dri-FIT-Cushion-Training-Socks/dp/B07CYVDSF4/...",
      "product_name": "NIKE Dri-FIT Cushion Crew Training Socks...",
      "product_rating": "4.6",
      "product_rating_object": {
        "five_star": 2758,
        "four_star": 306,
        "three_star": 136,
        "two_star": 34,
        "one_star": 170
      },
      "product_rating_max": 5,
      "rating": "4.0",
      "author_name": "Solomon Elimian",
      "asin": "B07CYVDSF4",
      "product_rating_count": 3406,
      "review_header": "Good",
      "review_id": "RPNTNLVT743KG",
      "review_text": "The quality is good, very comfortable...",
      "author_id": "AELRIOQYYVMXEEJOTPRYUAESFLYA",
      "author_link": "https://www.amazon.com/gp/profile/...",
      "badge": "Verified Purchase",
      "brand": "Nike",
      "review_posted_date": "May 29, 2025",
      "review_country": "United States",
      "helpful_count": 0,
      "is_amazon_vine": false,
      "is_verified": true,
      "variant_asin": null,
      "variant_name": null,
      "videos": null,
      "timestamp": "2025-06-10T03:58:54.982Z",
      "input": {
        "url": "https://www.amazon.com/Unisex-Dri-FIT-Cushion-Training-Socks/dp/B07CYVDSF4/..."
      }
    }
  ]
}

Parameters

Required Parameters

Parameter	Type	Description
location	string	Specifies the target region.
product_url_list	array	Accepts one or more Amazon product URLs.

Parameter Notes

• location defaults to US
• location supports multiple region values such as US, HK, CA, AD, and AE
• product_url_list defaults to an empty array and should contain product detail page URLs

Response Fields

Response data is returned under result[].

Field	Type	Description
url	string	Product page URL.
product_name	string	Product name.
product_rating	string	Overall product rating.
product_rating_object	object	Rating distribution by star level.
product_rating_max	number	Maximum rating value.
rating	string	Rating of the current review.
author_name	string	Review author name.
asin	string	Amazon ASIN.
product_rating_count	number	Total product rating count.
review_header	string	Review title.
review_id	string	Review ID.
review_text	string	Review body text.
author_id	string	Author ID.
author_link	string	Author profile link.
badge	string	Review badge such as Verified Purchase.
brand	string	Product brand.
review_posted_date	string	Review post date.
review_country	string	Review country or region.
helpful_count	number	Helpful vote count.
is_amazon_vine	boolean	Whether the review is from Amazon Vine.
is_verified	boolean	Whether the review is verified.
variant_asin	string	Variant ASIN.
variant_name	string	Variant name.
videos	array	Videos attached to the review.
timestamp	string	Crawl timestamp.
input	object	Original input information.

Rating Distribution Fields

product_rating_object includes:

Field	Type	Description
five_star	number	Number of 5-star reviews.
four_star	number	Number of 4-star reviews.
three_star	number	Number of 3-star reviews.
two_star	number	Number of 2-star reviews.
one_star	number	Number of 1-star reviews.

Input Fields

input includes:

Field	Type	Description
url	string	Product URL used in the request.

Previous pageAmazon Product Detail

Next pageAmazon Product Search