Amazon Product API — Getting Started — FetchLayer Docs
Documentation menu
FetchLayer FetchLayer API

Getting Started

Find the products you care about, check their current prices in one batch, then read any one of them in full.

1. Get your API key

Create an account and generate a FetchLayer API key from your dashboard. There is no Amazon account, no Product Advertising API approval and no Associates tag involved.

Create free account →

2. Find the products

Price checks and product details take ASINs. If you have a keyword instead, search for it — every result carries its ASIN.

bash
curl -X POST https://api.fetchlayer.dev/amazon/search-products \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"query":"mechanical keyboard","maxPrice":100,"marketplace":"com"}'

Tip

Already have an Amazon link? Send it to /resolve-url first — it returns the marketplace and ASIN, or the query and filters of a search URL, without contacting Amazon, and it does not consume a credit.

3. Check their prices

/price-check takes up to 20 ASINs or product URLs on one marketplace and returns the current price of each, with a per-product status. One product failing never fails the batch.

bash
curl -X POST https://api.fetchlayer.dev/amazon/price-check \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"asins":["B09B8V1LZ3","B00FLYWNYQ","B07S98411N"],"marketplace":"com"}'

fast or full

The default mode: "fast" prices the whole batch in the fewest page loads and is what a polling price monitor should use; seller and stock status come back only where they are free. mode: "full" reads every product page and returns seller and stock status for every product, with a full product-page load per product. Both return the same price.

4. Read one product in full

/product-details returns the title, brand, price and list price, stock, seller, aggregate rating, images, feature bullets, categories and every variation with its own ASIN.

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

Same ASIN, different marketplace

A product URL carries its own marketplace. Passing a marketplace that contradicts it is a 400 rather than a guess, because the same ASIN can be a different product, or no product, on another Amazon.

Errors and retries

A 400 names the field to fix and a 404 means the product does not exist on that marketplace — neither is worth retrying. A 502 or 503 means Amazon did not give a usable answer this time; retry after a short pause. Read notes on every successful response too.

Next steps