Amazon Product Reviews

2.62 credits/call
ae_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.

Productivity
2.62 credits/call

Pricing

2.62 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
asinstringYesProduct ASIN.—
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Unknow
review_typeenum (Both | Positive | Negative)NoReview sentiment to query. Defaults to Both.Both

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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