GET /v1/amazon/product

Returns structured data for a single Amazon product page.

Request

GET /api/v1/amazon/product?query=B09HN3Q81F&domain=com
Authorization: Bearer asa_live_YOUR_KEY

Query parameters

Param	Type	Required	Default	Description
query	string	✅ yes	-	10-character ASIN (or 10-char ISBN for books)
domain	enum	-	com	Amazon marketplace TLD: com, co.uk, de, fr, it, es, nl, pl, se, ca, com.mx, com.br, com.au, co.jp, sg, in, com.tr, ae, sa, eg
language	string	-	marketplace default	Content language as xx_YY (e.g. en_US, de_DE, es_ES). See supported languages per marketplace.
add_html	boolean	-	false	Attach the raw HTML of the Amazon page under html in the response
render_js	boolean	-	-	🔜 Coming soon - returns 501 today
screenshot	boolean	-	-	🔜 Coming soon - returns 501 today

Response (200)

{
  "asin": "B09HN3Q81F",
  "asin_in_url": "B09HN3Q81F",
  "parent_asin": null,
  "url": "https://www.amazon.com/dp/B09HN3Q81F",
  "page": 1,
  "page_type": "Product",

  "title": "LEGEND COOKWARE 5-Ply Stainless Steel Cookware Set",
  "product_name": "LEGEND COOKWARE 5-Ply Stainless Steel Cookware Set",
  "description": "Premium 5-ply construction distributes heat evenly …",
  "bullet_points": "5-PLY STAINLESS STEEL COOKWARE HEATS EVENLY\\n…",

  "brand": "LEGEND COOKWARE",
  "manufacturer": "LEGEND COOKWARE",
  "store_url": "https://www.amazon.com/stores/LEGEND+COOKWARE",

  "price": 299.99,
  "price_buybox": 299.99,
  "price_strikethrough": 399.99,
  "currency": "USD",
  "pricing_count": 3,

  "stock": "In Stock",
  "is_prime": true,
  "max_quantity": 10,

  "delivery": [
    { "date": { "by": "Tuesday, April 25" }, "type": "FREE Delivery" }
  ],
  "featured_merchant": {
    "name": "LEGEND COOKWARE Store",
    "seller_id": "A1EXAMPLE",
    "is_amazon_fulfilled": true
  },
  "buybox": [
    {
      "price": 299.99,
      "seller_name": "LEGEND COOKWARE Store",
      "seller_id": "A1EXAMPLE",
      "stock": "In Stock",
      "returns": "Free returns within 30 days"
    }
  ],

  "category": [
    { "ladder": [
      { "name": "Home & Kitchen", "url": "…" },
      { "name": "Kitchen & Dining", "url": "…" },
      { "name": "Cookware", "url": "…" }
    ]}
  ],

  "rating": 4.7,
  "reviews_count": 2481,
  "rating_stars_distribution": [
    { "rating": 5, "percentage": 72 },
    { "rating": 4, "percentage": 18 },
    { "rating": 3, "percentage": 6 },
    { "rating": 2, "percentage": 2 },
    { "rating": 1, "percentage": 2 }
  ],
  "reviews": [
    {
      "id": "R1…",
      "author": "J. Smith",
      "title": "Excellent build quality",
      "content": "These pans heat evenly and clean up beautifully.",
      "rating": 5,
      "timestamp": "Reviewed in the United States on April 12, 2026",
      "is_verified": true,
      "helpful_count": 12
    }
    /* ~8 more */
  ],
  "answered_questions_count": 23,

  "variations": [
    { "asin": "B09HN3Q81F", "dimensions": { "color": "Silver", "size": "10 pc" }, "selected": true },
    { "asin": "B09HN3Q81G", "dimensions": { "color": "Copper", "size": "10 pc" }, "selected": false }
  ],

  "images": [
    "https://m.media-amazon.com/images/I/71…",
    "https://m.media-amazon.com/images/I/81…"
  ],
  "has_videos": true,

  "product_details": { "Brand": "LEGEND COOKWARE", "Material": "Stainless Steel" },
  "product_dimensions": "17.1 x 13.1 x 12.6 inches",
  "sales_rank": [
    { "ladder": [{ "name": "Home & Kitchen", "url": "…" }], "rank": 342 }
  ]
}

Response headers

• Asa-Cost - credits spent on this request (5 for a standard product scrape, 0 for any non-2xx response)
• Asa-Resolved-Url - the final Amazon URL after any redirects
• Asa-Source-Status - Amazon’s raw HTTP status (may differ from our HTTP status)
• Asa-Attempts - how many internal attempts it took us to get this result
• Asa-Extractor-Version - e.g. amazon@1.0.0

Errors

HTTP	Body	Reason
400	{"error":"invalid_params"}	ASIN not 10 alphanumeric chars, domain not in enum
401	{"error":"unauthorized"}	Missing / bad API key
429	{"error":"rate_limited"}	Too many requests from your key
501	{"error":"not_implemented","params":["render_js"]}	You passed a roadmap param
502	{"error":"target_unreachable"}	Amazon blocked every internal retry we made
502	{"error":"extraction_failed"}	Amazon served something we couldn’t parse
502	{"error":"asin_mismatch"}	Requested ASIN redirected to a different product
502	{"error":"generic_gallery_page"}	Amazon served a placeholder gallery (delisted product)

Related

• Search endpoint
• Async batch endpoint
• Country + content language guide
• Billing policy - only-2xx billing