Amazon Media

Return product media from an Amazon product URL or ASIN, including image gallery, high-resolution images, and best-effort video metadata.

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
asin	string	optional	Direct Amazon product ASIN. Required unless url is supplied.
url	string	optional	Direct Amazon product URL. Required unless asin is supplied.
domain	string	optional	Amazon domain.
country	string	optional	Delivery or marketplace country code.
postal_code	string	optional	Delivery postal code.

Response Fields

Field	Type	Description
success	boolean	Whether media extraction completed.
images	array	Unique product image URLs.
gallery_images	array	Gallery image URLs.
high_resolution_images	array	High-resolution image URLs.
videos_count / video_types	number \| array	Best-effort video count and type labels when visible.
product	object	Underlying enriched Amazon product row.
time_taken	number	API response time in seconds.

cURL Example

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"
}'

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,
  "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
}