Amazon Reviews Endpoint
Return public product-page review previews and rating details for one Amazon product.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Run Amazon Reviews
Send the smallest useful request and read the structured 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,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Options
Query and Target
Set the search term, identifier, or source URL that defines the request.
curl -X POST "https://api.datablue.dev/v1/data/amazon/reviews" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asin": "B0EXAMPLE1",
"domain": "amazon.in",
"limit": 10,
"sort_by": "recent",
"url": "https://example.com/products/widget"
}'Example response
{
"success": true,
"asin": "B0XXXXXXX1",
"domain": "amazon.in",
"title": "Kiro Beauty Lipstick",
"rating": 4.3,
"review_count": 218,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Results and Pagination
Control how many records or pages are returned.
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,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Location and Language
Localize results with country, language, coordinates, or delivery-location fields.
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",
"country": "us",
"postal_code": "10001"
}'Example response
{
"success": true,
"asin": "B0XXXXXXX1",
"domain": "amazon.in",
"title": "Kiro Beauty Lipstick",
"rating": 4.3,
"review_count": 218,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Filters and Sorting
Narrow or order the returned records.
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": "example"
}'Example response
{
"success": true,
"asin": "B0XXXXXXX1",
"domain": "amazon.in",
"title": "Kiro Beauty Lipstick",
"rating": 4.3,
"review_count": 218,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Additional Options
Set endpoint-specific options for this request.
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",
"star_filter": [
"example"
]
}'Example response
{
"success": true,
"asin": "B0XXXXXXX1",
"domain": "amazon.in",
"title": "Kiro Beauty Lipstick",
"rating": 4.3,
"review_count": 218,
"source": "public_product_page",
"partial": false,
"reviews": [
{
"rating": 5,
"title": "Great shade",
"body": "Smooth finish and good pigment."
}
],
"time_taken": 4.1
}Response
Read success first, then consume the endpoint-specific records and pagination fields shown below.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.