Amazon Reviews

Return parsed review snippets and rating metadata 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

Name	Type	Requirement	Description
asin	string	optional	Direct Amazon product ASIN. Required unless url is supplied.
url	string	optional	Direct Amazon product URL. Required unless asin is supplied.
domain	string	optional	Amazon domain.
country	string	optional	Delivery or marketplace country code.
postal_code	string	optional	Delivery postal code.
limit	number	optional	Maximum review snippets to return (1-50).
sort_by	string	optional	Review sort where supported: top, recent, rating_high, rating_low.

Response Fields

Field	Type	Description
success	boolean	Whether review parsing completed.
rating / review_count	number	Product rating metadata.
reviews	array	Review snippets with author, rating, title, body, date, and helpful metadata when available.
time_taken	number	API response time in seconds.

cURL Example

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"
}'

System Responses

200 OK

Request processed successfully.

401 UNAUTHORIZED

Missing or invalid API key.

429 RATE LIMIT

System capacity exceeded.

500 SYSTEM FAILURE

Internal core exception.

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
}