---
title: Product endpoint
description: Extract full product data for a single Amazon ASIN  -  ~55 structured fields including price, variations, buybox, images, category ladder.
order: 10
---

# `GET /v1/amazon/product`

Returns structured data for a single Amazon product page.

## Request

```http
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](/docs/guides/country-and-language). |
| `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)

```json
{
  "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](/docs/endpoints/search)
- [Async batch endpoint](/docs/endpoints/batch)
- [Country + content language guide](/docs/guides/country-and-language)
- [Billing policy  -  only-2xx billing](/docs/guides/billing)