Docs / API reference

POST/v1/data/amazon/media

Amazon Media

Return images and available video metadata for one Amazon product.

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.

Amazon Media Endpoint

Return images and available video metadata for one Amazon product.

Getting Started

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

Run Amazon Media

Send the smallest useful request and read the structured response.

curl -X POST "https://api.datablue.dev/v1/data/amazon/media" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in"
}'
Example response
{
  "success": true,
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "title": "Kiro Beauty Lipstick",
  "images": [
    "https://m.media-amazon.com/images/I/example.jpg"
  ],
  "gallery_images": [
    "https://m.media-amazon.com/images/I/gallery.jpg"
  ],
  "high_resolution_images": [
    "https://m.media-amazon.com/images/I/hires.jpg"
  ],
  "videos_count": 1,
  "video_types": [
    "product_video"
  ],
  "time_taken": 3.8
}

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/media" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asin": "B0EXAMPLE1",
  "domain": "amazon.in",
  "url": "https://example.com/products/widget"
}'
Example response
{
  "success": true,
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "title": "Kiro Beauty Lipstick",
  "images": [
    "https://m.media-amazon.com/images/I/example.jpg"
  ],
  "gallery_images": [
    "https://m.media-amazon.com/images/I/gallery.jpg"
  ],
  "high_resolution_images": [
    "https://m.media-amazon.com/images/I/hires.jpg"
  ],
  "videos_count": 1,
  "video_types": [
    "product_video"
  ],
  "time_taken": 3.8
}

Location and Language

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

curl -X POST "https://api.datablue.dev/v1/data/amazon/media" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "country": "us",
  "postal_code": "10001"
}'
Example response
{
  "success": true,
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "title": "Kiro Beauty Lipstick",
  "images": [
    "https://m.media-amazon.com/images/I/example.jpg"
  ],
  "gallery_images": [
    "https://m.media-amazon.com/images/I/gallery.jpg"
  ],
  "high_resolution_images": [
    "https://m.media-amazon.com/images/I/hires.jpg"
  ],
  "videos_count": 1,
  "video_types": [
    "product_video"
  ],
  "time_taken": 3.8
}

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.

Parameters

NameTypeRequirementDescription
asinstringOptionalDirect Amazon product ASIN. Required unless url is supplied.
urlstringOptionalDirect Amazon product URL. Required unless asin is supplied.
domainstringOptionalAmazon domain.
countrystringOptionalDelivery or marketplace country code.
postal_codestringOptionalDelivery postal code.

Response fields

FieldTypeDescription
successbooleanWhether media extraction completed.
imagesarrayUnique product image URLs.
gallery_imagesarrayGallery image URLs.
high_resolution_imagesarrayHigh-resolution image URLs.
videos_count / video_typesnumber | arrayBest-effort video count and type labels when visible.
productobjectUnderlying enriched Amazon product row.
job_id / status_urlstringPresent only when unfinished work returns HTTP 202 for polling.
time_takennumberAPI response time in seconds.

Request and response

curl -X POST "https://api.datablue.dev/v1/data/amazon/media" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in"
}'
Example response
{
  "success": true,
  "asin": "B0XXXXXXX1",
  "domain": "amazon.in",
  "title": "Kiro Beauty Lipstick",
  "images": [
    "https://m.media-amazon.com/images/I/example.jpg"
  ],
  "gallery_images": [
    "https://m.media-amazon.com/images/I/gallery.jpg"
  ],
  "high_resolution_images": [
    "https://m.media-amazon.com/images/I/hires.jpg"
  ],
  "videos_count": 1,
  "video_types": [
    "product_video"
  ],
  "time_taken": 3.8
}