Amazon Product API — Product Details by ASIN
Documentation menu
FetchLayer FetchLayer API

Get one product in full

Read one Amazon product from its ASIN or product URL: title and brand, the featured offer’s price, the crossed-out list price and savings percent when it is discounted, availability and seller, the aggregate star rating and how many ratings it is based on, every gallery image at its largest size, the About this item bullets, the category breadcrumb, and the whole variation family — the parent ASIN, what the variations differ by, and every size, colour or style with its own ASIN. Prices are quoted for the delivery location the response names. Individual customer reviews are not part of this API; rating is the aggregate only. A product that does not exist on the marketplace is a 404.

POST /product-details Products
https://api.fetchlayer.dev/amazon/product-details
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

product string required

An ASIN (with marketplace), or an Amazon product URL on any supported marketplace.

marketplace string optional

Amazon marketplace as its domain suffix: com, co.uk, de, fr, it, es, nl, com.be, se, pl, ca, com.mx, com.br, com.au, co.jp, in, sg, com.tr, ae, sa. amazon.co.uk and uk are accepted too. A product URL carries its own marketplace, and naming a different one here is a 400. (default: com)

postalCode string optional

The delivery postal code prices and stock are quoted for. Defaults to a central postal code in the marketplace's country: 10001 for com, SW1A 1AA for co.uk, 10115 for de.

format string optional

json or markdown. (default: json)

timeoutMs number optional

Per-request time limit in milliseconds (max 600000).

Response Fields

product-details

Get one product in full

marketplace string

The Amazon marketplace, as its domain suffix.

deliveryLocation object

Where the prices apply: postalCode and Amazon’s own label for it. postalCode is null when a price could not be quoted for the postal code you asked for — notes says so.

notes string[]

Caveats about this particular result — a price quoted for a different location than asked for, a filter that could not be applied, products to retry. Read it on every call.

transport string

The source this data came from. Always "amazon".

scrapedAt string

ISO 8601 timestamp of when the data was collected.

asin string

The product’s ASIN.

url string

The product page URL.

title string

The product title as the page shows it.

brand string

The brand as the page shows it.

price object

The featured offer’s price: { amount, currency, display } in the currency the page actually quoted, or null.

listPrice object

The crossed-out reference price, only when it is higher than price. A "was" price equal to the current price is left out.

savingsPercent number

The percentage off listPrice, as the page states it.

availability object

{ status, text } — status is one of in_stock, low_stock, out_of_stock, undeliverable, preorder, unknown. Branch on status, not on Amazon’s wording in text.

seller object

{ name, id } of the featured offer’s seller.

hasFeaturedOffer boolean

Whether there is an offer that Add to Cart buys.

rating object

{ average, count } — the aggregate star rating and how many ratings it is based on.

images object[]

Every gallery image at its largest size, each { url, variant }. MAIN is the lead image.

features string[]

The About this item bullets.

categories string[]

The category breadcrumb, broadest first. Empty when the page shows none.

parentAsin string

The listing this family of variations belongs to.

variationDimensions string[]

What the variations differ by, for example ["Size"] or ["Color", "Style Name"].

variations object[]

Every size, colour or style in the family: { asin, values, selected }, where selected marks the product you asked for.

Request

curl -X POST "https://api.fetchlayer.dev/amazon/product-details" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"product":"B09B8V1LZ3"}'

Response

{
  "asin": "B09B8V1LZ3",
  "url": "https://www.amazon.com/dp/B09B8V1LZ3",
  "marketplace": "com",
  "title": "Amazon Echo Dot (newest model) - Vibrant sounding speaker, Designed for Alexa+, Great for bedrooms, dining rooms and offices, Charcoal",
  "brand": "Amazon",
  "price": {
    "amount": 79.99,
    "currency": "USD",
    "display": "$79.99"
  },
  "listPrice": null,
  "savingsPercent": null,
  "availability": {
    "status": "in_stock",
    "text": "In Stock"
  },
  "seller": {
    "name": "Amazon.com",
    "id": "ATVPDKIKX0DER"
  },
  "hasFeaturedOffer": true,
  "rating": {
    "average": 4.7,
    "count": 199523
  },
  "images": [
    {
      "url": "https://m.media-amazon.com/images/I/71hNp8d9WvL._AC_SL1500_.jpg",
      "variant": "MAIN"
    }
  ],
  "features": [
    "Your favorite music and content – Play music, audiobooks, and podcasts from Amazon Music, Apple Music, Spotify and others or via Bluetooth throughout your home."
  ],
  "categories": [],
  "parentAsin": "B0BF73CTQF",
  "variationDimensions": [
    "Color",
    "Configuration"
  ],
  "variations": [
    {
      "asin": "B09B94RL1R",
      "values": [
        "Glacier White",
        "Device only"
      ],
      "selected": false
    },
    {
      "asin": "B09B8V1LZ3",
      "values": [
        "Charcoal",
        "Device only"
      ],
      "selected": true
    }
  ],
  "deliveryLocation": {
    "postalCode": "10001",
    "label": "New York 10001"
  },
  "notes": [],
  "transport": "amazon",
  "scrapedAt": "2026-09-12T22:17:10.176Z"
}