DataBlue / Docs / Endpoint
POST/v1/data/amazon/store
Amazon Store
Extract SKU/product rows from an Amazon brand store URL. Returns SKU summaries and enriched product rows when include_product_details is enabled.
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 |
|---|---|---|---|
| url | string | REQUIRED | Amazon brand/store URL. |
| domain | string | optional | Amazon domain. |
| country | string | optional | Delivery or marketplace country code. |
| postal_code | string | optional | Delivery postal code. |
| num_results | number | optional | Maximum SKUs/products to fetch (1-960). |
| include_product_details | boolean | optional | Fetch product detail pages for each store SKU. |
| include_offers | boolean | optional | Include offer data when enrichment is available. |
| max_offers | number | optional | Maximum offers per product (0-20). |
| include_sellers | boolean | optional | Include seller details when available. |
| include_reviews_preview | boolean | optional | Include review snippets when available. |
Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request completed successfully. |
| total_skus | number | Number of SKU rows extracted. |
| skus | array | SKU rows with position, ASIN, title, URL, brand, price, rating, review_count, and image. |
| products | array | Enriched Amazon product rows when requested. |
| pages_fetched | number | Number of store/listing pages fetched. |
| time_taken | number | API response time in seconds. |
cURL Example
curl -X POST "https://api.datablue.dev/v1/data/amazon/store" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.amazon.in/stores/page/02D3EE5F-D59D-4010-B7E4-5F106ED3F47B/",
"domain": "amazon.in",
"country": "IN",
"postal_code": "560034",
"num_results": 50,
"include_product_details": true
}'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,
"url": "https://www.amazon.in/stores/page/example",
"domain": "amazon.in",
"total_skus": 2,
"pages_fetched": 1,
"time_taken": 5.4,
"skus": [
{
"position": 1,
"asin": "B0XXXXXXX1",
"title": "Kiro Beauty Lipstick",
"url": "https://www.amazon.in/dp/B0XXXXXXX1",
"price": "₹799",
"rating": 4.3
}
],
"products": []
}