Amazon Products Endpoint
Search listings or enrich products from a URL, URL list, or ASIN.
Getting Started
Send your API key as a bearer token. Start with the smallest request below.
Search Products
Start with listing detail for the fastest product search.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "wireless headphones",
"domain": "amazon.in",
"num_results": 10
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Product Sources
Use an Amazon URL
Send a search, category, bestseller, or product URL.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.amazon.in/s?k=wireless+headphones",
"domain": "amazon.in"
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Use Multiple URLs
Send start_urls for a bounded list of Amazon sources.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"start_urls": [
"https://www.amazon.in/s?k=wireless+headphones",
"https://www.amazon.in/gp/bestsellers/electronics"
],
"domain": "amazon.in"
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Use an ASIN
Send one ASIN for direct product enrichment.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asin": "B0EXAMPLE1",
"domain": "amazon.in",
"detail_level": "full"
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Enrich an ASIN Batch
Send up to 50 ASINs. Batch and other deep requests use the durable queue when needed.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asins": [
"B0EXAMPLE1",
"B0EXAMPLE2"
],
"domain": "amazon.in",
"detail_level": "full",
"reviews_limit": 8
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Marketplace and Limits
Set Pages and Delivery
Control listing pages and the marketplace delivery context.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "wireless headphones",
"num_results": 40,
"page": 1,
"page_limit": 4,
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"language": "en"
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Listing Filters
Filter and Sort
Apply price, Prime, and supported sort filters.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "wireless headphones",
"sort_by": "rating",
"min_price": 1000,
"max_price": 5000,
"prime_only": true
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Product Enrichment
Request Full Details
Enable only the detail blocks your application needs.
curl -X POST "https://api.datablue.dev/v1/data/amazon/products" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"asin": "B0EXAMPLE1",
"detail_level": "full",
"include_offers": true,
"max_offers": 5,
"include_sellers": true,
"include_variants": true,
"include_reviews_preview": true,
"reviews_limit": 8
}'Example response
{
"success": true,
"query": "kiro beauty lipstick",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"detail_level": "full",
"total_results": "24",
"pages_fetched": 1,
"time_taken": 3.21,
"products": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"price_value": 799,
"rating": 4.3,
"review_count": 218,
"rating_breakdown": {
"5star": 0.59,
"4star": 0.19,
"3star": 0.09,
"2star": 0.03,
"1star": 0.1
},
"delivery": "Saturday, 25 July"
}
]
}Response
HTTP 200 returns final normalized rows in products. If deep work is still running after 300 seconds, HTTP 202 returns job_id and status_url. Read detail_enriched, partial, quality, and warnings before consuming source-dependent fields.
Error Handling
Handle 401 for authentication, 422 for invalid input, 429 for limits, and retry only transient failures.