Docs/Amazon Reviews
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
| 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 details. |
| reviews | array | Review snippets with author, rating, title, body, date, and helpful vote details when available. |
| time_taken | number | API 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
}