Docs / API reference

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.

Request and response

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
}'
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": []
}