Docs / API reference

POST/v1/data/amazon/reviews

Amazon Reviews

Return parsed review snippets and rating details for an Amazon product URL or ASIN.

Execution model

Live request

Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.

Credit weight

Live catalog

Current weights are managed from the Data API Weights admin table and shown on pricing before use.

Parameters

NameTypeRequirementDescription
asinstringOptionalDirect Amazon product ASIN. Required unless url is supplied.
urlstringOptionalDirect Amazon product URL. Required unless asin is supplied.
domainstringOptionalAmazon domain.
countrystringOptionalDelivery or marketplace country code.
postal_codestringOptionalDelivery postal code.
limitnumberOptionalMaximum review snippets to return (1-50).
sort_bystringOptionalReview sort where supported: top, recent, rating_high, rating_low.

Response fields

FieldTypeDescription
successbooleanWhether review parsing completed.
rating / review_countnumberProduct rating details.
reviewsarrayReview snippets with author, rating, title, body, date, and helpful vote details when available.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/amazon/reviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "limit": 10,
  "sort_by": "recent"
}'
Example response
{
  "success": true,
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "title": "Kiro Beauty Lipstick",
  "rating": 4.3,
  "review_count": 218,
  "reviews": [
    {
      "rating": 5,
      "title": "Great shade",
      "body": "Smooth finish and good pigment."
    }
  ],
  "time_taken": 4.1
}