Amazon Product Reviews
Retrieve up to 100 Amazon user reviews from the last year for a product using its ASIN. Optionally select a supported marketplace with amz_site (default: Unknow) and choose both positive and negative reviews, positive reviews only, or negative reviews only with review_type (Both, Positive, or Negative; default: Both). Useful for examining recent customer feedback; results are not guaranteed to include every review, and the provider does not specify a structured response schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.62 credits/call |
The fixed charge is 2.62 credits per call, regardless of the number of reviews returned. The selected marketplace and review type do not affect the charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | Yes | Product ASIN. | — |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
review_type | enum (Both | Positive | Negative) | No | Review sentiment to query. Defaults to Both. | Both |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amazon_product_reviews' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"asin": "B0G6Z298S5",
"review_type": "Both"
}
}'{
"data": [
{
"content": "The Machotstl Sapling Puller Tool has been a game changer for my dad, [REDACTED]. Here’s a comprehensive review of this tool and its benefits for gardening without the strain of kneeling.\nThis heavy duty sapling puller is designed to remove small trees, sh",
"review_date": "20260423",
"star_rating": 5.0,
"title": "It’s been a blessing",
"variant_attribute": ""
}
],
"doc": {
"content": "Review content.",
"review_date": "Review date in yyyyMMdd format.",
"star_rating": "Star rating (1.0 ~ 5.0).",
"title": "Review title.",
"variant_attribute": "Variant attribute of the reviewed child ASIN (e.g. Color=Red)."
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

