Amazon Store

Amazon Store Endpoint

Extract SKU rows and optional product details from an Amazon brand store.

Getting Started

Send your API key as a bearer token. Start with the smallest request below.

Run Amazon Store

Send the smallest useful request and read the structured 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": [
    {
      "position": 1,
      "asin": "B0XXXXXXX1",
      "title": "Kiro Beauty Lipstick",
      "url": "https://www.amazon.in/dp/B0XXXXXXX1",
      "detail_enriched": true,
      "rating_breakdown": {
        "5star": 0.59,
        "4star": 0.19
      }
    }
  ]
}

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/store" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com/products/widget",
  "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": [
    {
      "position": 1,
      "asin": "B0XXXXXXX1",
      "title": "Kiro Beauty Lipstick",
      "url": "https://www.amazon.in/dp/B0XXXXXXX1",
      "detail_enriched": true,
      "rating_breakdown": {
        "5star": 0.59,
        "4star": 0.19
      }
    }
  ]
}

Results and Pagination

Control how many records or pages are returned.

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": 100,
  "include_product_details": true,
  "max_offers": 0
}'

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": [
    {
      "position": 1,
      "asin": "B0XXXXXXX1",
      "title": "Kiro Beauty Lipstick",
      "url": "https://www.amazon.in/dp/B0XXXXXXX1",
      "detail_enriched": true,
      "rating_breakdown": {
        "5star": 0.59,
        "4star": 0.19
      }
    }
  ]
}

Location and Language

Localize results with country, language, coordinates, or delivery-location fields.

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": "us",
  "postal_code": "10001",
  "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": [
    {
      "position": 1,
      "asin": "B0XXXXXXX1",
      "title": "Kiro Beauty Lipstick",
      "url": "https://www.amazon.in/dp/B0XXXXXXX1",
      "detail_enriched": true,
      "rating_breakdown": {
        "5star": 0.59,
        "4star": 0.19
      }
    }
  ]
}

Details and Enrichment

Choose the additional detail, related records, or media included in the 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,
  "include_offers": false,
  "include_sellers": false,
  "include_reviews_preview": false
}'

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": [
    {
      "position": 1,
      "asin": "B0XXXXXXX1",
      "title": "Kiro Beauty Lipstick",
      "url": "https://www.amazon.in/dp/B0XXXXXXX1",
      "detail_enriched": true,
      "rating_breakdown": {
        "5star": 0.59,
        "4star": 0.19
      }
    }
  ]
}

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.

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.

Field	Type	Description
success	boolean	Whether the request completed or queued successfully.
status	string	completed, partial, failed, queued, running, or cancelled.
total_skus	number	Number of SKU rows extracted.
skus	array	Lightweight catalog rows with position, ASIN, title, URL, brand, price, rating, review_count, and image.
products	array	Full Amazon product rows when include_product_details=true, including detail_enriched and source-available detail, A+, review-preview, offer, seller, variant, and media fields.
pages_fetched	number	Number of store/listing pages fetched.
partial / warnings	boolean \| string[]	Completeness signal and non-fatal source or enrichment warnings.
job_id / status_url	string	Present only when unfinished work returns HTTP 202 for polling.
time_taken	number	API response time in seconds.

Amazon Store Endpoint

Getting Started

Run Amazon Store

Options

Query and Target

Location and Language

Details and Enrichment

Response

Error Handling

Parameters

Response fields

Request and response