Amazon Store
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

NameTypeRequirementDescription
urlstringREQUIREDAmazon brand/store URL.
domainstringoptionalAmazon domain.
countrystringoptionalDelivery or marketplace country code.
postal_codestringoptionalDelivery postal code.
num_resultsnumberoptionalMaximum SKUs/products to fetch (1-960).
include_product_detailsbooleanoptionalFetch product detail pages for each store SKU.
include_offersbooleanoptionalInclude offer data when enrichment is available.
max_offersnumberoptionalMaximum offers per product (0-20).
include_sellersbooleanoptionalInclude seller details when available.
include_reviews_previewbooleanoptionalInclude review snippets when available.

Response Fields

FieldTypeDescription
successbooleanWhether the request completed successfully.
total_skusnumberNumber of SKU rows extracted.
skusarraySKU rows with position, ASIN, title, URL, brand, price, rating, review_count, and image.
productsarrayEnriched Amazon product rows when requested.
pages_fetchednumberNumber of store/listing pages fetched.
time_takennumberAPI 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": []
}