Amazon API & Scraper
The Amazon Product Data API returns product, review, offer and search data across Amazon marketplaces as clean JSON.
- Success rate
- 99.7%
- Median response
- 3.4 s
- Endpoints
- 15
How we count
A call counts as failed only when the problem is on our side: the site blocked us, the source returned an error, we could not parse the page, or it timed out. Not-found results, invalid or missing parameters, used-up credit and rate limits are not failures of the API and are left out. Our own test traffic is excluded. The window is the last 30 days and moves once a week.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
The primary product/detail endpoint returns an ASIN's title, price, rating, brand, features, images, variations, tech specs and A+ content — the full product page as structured data. You can also pull product/reviews, product/offers (the buy-box and third-party sellers), run a search, and list bestsellers and new-releases. It is the managed alternative to building an Amazon scraper — no proxies, no captcha handling, no browser fleet — for pricing intelligence, catalog enrichment and review analysis. One ReefAPI key, one shared credit pool, the standard envelope.
What Amazon data you get in each of the 23 marketplaces
One row per Amazon marketplace, measured on 2026-11-16 (all 15 actions in every marketplace; inputs from each marketplace's own pages). marketplace sets the language of every text field and the currency of every price. currency is the symbol Amazon prints; currency_code is the ISO code.
| marketplace | Site | Country | currency_code | Example price as printed | What differs here |
|---|---|---|---|---|---|
| com (default) | amazon.com | United States | USD | $29.74 | product/reviews reads the same ASIN on amazon.ca, amazon.co.uk or amazon.de (amazon.com hides reviews from signed-out visitors); search up to 48 rows a page |
| co.uk | amazon.co.uk | United Kingdom | GBP | £29.99 | search returns 16 rows a page |
| de | amazon.de | Germany | EUR | 29,99 € | search returns 16 rows a page |
| fr | amazon.fr | France | EUR | 12,98 € | Nothing: every field measured was filled |
| it | amazon.it | Italy | EUR | 29,99 € | Nothing: every field measured was filled |
| es | amazon.es | Spain | EUR | 29,99 € | Nothing: every field measured was filled |
| nl | amazon.nl | Netherlands | EUR | €14,86 | no "Customers say" summary on the product page |
| com.be | amazon.com.be | Belgium | EUR | €18.99 | no "Customers say" summary |
| ie | amazon.ie | Ireland | EUR | €32.90 | "bought in the past month" is not printed |
| se | amazon.se | Sweden | SEK | 290,00 kr | no "Customers say" summary |
| pl | amazon.pl | Poland | PLN | 55,00 zł | no "Customers say" summary |
| com.tr | amazon.com.tr | Türkiye | TRY | 499,00 TL | no "Customers say" summary; deals 36 rows |
| ae | amazon.ae | United Arab Emirates | AED | AED 129.00 | Nothing: every field measured was filled |
| sa | amazon.sa | Saudi Arabia | SAR | SAR 179.00 | no "Customers say" summary |
| eg | amazon.eg | Egypt | EGP | EGP 1,856.78 | no "Customers say" summary; deals 20 rows |
| in | amazon.in | India | INR | ₹599.00 | product/reviews 8 reviews |
| co.jp | amazon.co.jp | Japan | JPY | ¥1,963 | product/reviews 8 reviews; BSR printed as 家電&カメラ - 22位 and read |
| sg | amazon.sg | Singapore | SGD | S$123.57 | delivery message and "bought in the past month" are not printed; the buy box is often a cross-border Amazon US / Germany / Japan offer; deals 12 rows |
| com.au | amazon.com.au | Australia | AUD | $66.49 AUD | Nothing: every field measured was filled |
| ca | amazon.ca | Canada | CAD | $47.99 CAD | deals 12 rows |
| com.mx | amazon.com.mx | Mexico | MXN | $199.00 MXN | Nothing: every field measured was filled |
| com.br | amazon.com.br | Brazil | BRL | R$94,02 | no "Customers say" summary; deals 58 rows |
| co.za | amazon.co.za | South Africa | ZAR | R199.00 | slowest marketplace: Amazon sometimes answers with a bot check that the engine retries, so search can take up to about a minute; product/reviews 8 reviews; "bought in the past month" is not printed |
In every marketplace product/detail filled price, rating, rating count, star distribution, stock, brand, features, images, variations, specifications, the buy-box seller and Best Sellers Rank. An ASIN is per marketplace: the same ASIN can be sold on several at different prices, or on none; a missing one returns NOT_FOUND (not charged). Apple and Beats "premium" product pages load related products, BSR and A+ content later in the browser, so those stay empty there.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/amazon/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "laptop"
}
}{
"ok": true,
"meta": {
"api": "amazon",
"endpoint": "search",
"mode": "live",
"latency_ms": 2675.3,
"record_count": 16,
"bytes": 1677407,
"cache_hit": false,
"completeness_pct": 100,
"marketplace": "com",
"currency_code": "USD",
"pagination": {
"page": 1,
"has_more": true
},
"charged_credits": 1,
"version": "0.1.0"
},
"data": {
"results": [
{
"asin": "B0H5BTZFC1",
"title": "15.6 Inch Laptop Computer, N4020, 4GB DDR4 RAM, 128GB eMMC,with Windows 11",
"brand": null,
"price": 229.99,
"currency": "$",
"rating": 4.8,
"rating_count": 2024,
"image": "https://m.media-amazon.com/images/I/718nDryvGTL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": null,
"availability": null,
"in_stock": true,
"currency_code": "USD"
},
{
"asin": "B0HFNC155T",
"title": "15.6 Inch Laptop with FHD display, 6GB RAM 128GB Storage Expandable 512GB",
"brand": null,
"price": 259.99,
"currency": "$",
"rating": 4.9,
"rating_count": 30,
"image": "https://m.media-amazon.com/images/I/81xYyz6RqhL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": "Limited time deal",
"availability": null,
"in_stock": true,
"currency_code": "USD"
},
{
"asin": "B0H3P26C4C",
"title": "HP Everyday Slim Laptop • 2026-2027 Edition • Microsoft Office 365 Included • Intel N150 CPU • 128GB SSD + 1TB Cloud Storage • Stunning Color • Copilot AI • Windows 11",
"brand": null,
"price": 299.99,
"currency": "$",
"rating": 5,
"rating_count": 1,
"image": "https://m.media-amazon.com/images/I/71is4WH8YTL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": "Limited time deal",
"availability": null,
"in_stock": true,
"currency_code": "USD"
}
],
"page": 1
}
}What the Amazon API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| product/detail | full product page (title/price/currency/rating/count/brand/features/images/categories/variations/tech-specs/A+content/compare-similar) + top-8 inline reviews, by ASIN | Pricing teams call product/detail to get full product page (title/price/currency/rating/count/brand/features/images/categories/variati…. | asin, marketplace, include_reviews, fields, exclude |
| product/reviews | Amazon product reviews by ASIN — the public top reviews Amazon shows on the product page (typically 5-13 per site; Amazon's full review list and its pagination require sign-in on every Amazon site), optionally merged + deduped across several marketplaces for more depth. amazon.com currently shows no reviews to signed-out visitors; for a `com` request the same product's top reviews are read from amazon.ca, then amazon.co.uk, then amazon.de (most are 'Reviewed in the United States'), and `fallback_marketplaces` says which site supplied them. Each review has author, rating, title, date, location, body, verified badge, helpful votes and the marketplace it was read from. | Marketplace operators call product/reviews to get amazon product reviews by ASIN. | asin, marketplace, marketplaces |
| product/offers | pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN | Catalog enrichment teams call product/offers to get pinned buybox + all-offers (AOD aodAjaxMain). | asin, marketplace |
| search | product search with optional filters (price range, minimum rating, deals, brand) → results[]{asin,title,price,currency,rating,rating_count,image,sponsored,url} | Retail analysts call search to get product search with optional filters (price range, minimum rating, deals, brand) → results[]{…. | query, marketplace, page, max_results, sort, ... |
| products_batch | Look up MANY Amazon products in ONE call by ASIN — up to 40 per request → each product's title, current price and currency, star rating with review count, image, and any clippable coupon or deal badge. ONE upstream request serves the whole list (not one per ASIN), so this is the cheap way to refresh a price list or reconcile a catalogue against Amazon. IMPORTANT — this returns the SUMMARY card for each product, which is what Amazon publishes on a multi-product surface. For features, technical specifications, variations, barcodes, A+ content or reviews, use product/detail, which reads the full product page and costs one call per ASIN. | Pricing teams call products_batch to look up MANY Amazon products in ONE call by ASIN. | asins, marketplace |
| category/browse | Browse a department or sub-department by its Amazon browse NODE id and page through the grid — the catalogue-walking counterpart to `search`, for when you want everything in a category rather than everything matching a phrase. Node ids come from a category URL (the number after `node=` / `n%3A`). Pagination is page-native: keep asking for the next page while `has_next` is true; an empty page means you reached the end. There is deliberately NO total count — Amazon's own result-count value swings between identical requests, so publishing it would hand you a number you cannot rely on. | Marketplace operators call category/browse to get browse a department or sub-department by its Amazon browse NODE id and page through the grid. | node, marketplace, page |
| bestsellers | best-sellers ranking for a department (category slug required) | Catalog enrichment teams call bestsellers to get best-sellers ranking for a department (category slug required). | category, marketplace, max_results |
| new-releases | new-releases ranking for a department (category slug required) | Retail analysts call new-releases to get new-releases ranking for a department (category slug required). | category, marketplace, max_results |
| seller/profile | seller profile (name, feedback %, lifetime ratings, rating) | Pricing teams call seller/profile to get seller profile (name, feedback %, lifetime ratings, rating). | seller_id, marketplace |
| autocomplete | search autocomplete suggestions | Marketplace operators call autocomplete to search autocomplete suggestions. | query, marketplace |
| seller/products | a seller's catalog/storefront by seller_id (paginated) | Catalog enrichment teams call seller/products to get a seller's catalog/storefront by seller_id (paginated). | seller_id, marketplace, page |
| seller/reviews | seller FEEDBACK reviews (rating/text/rater/date) by seller_id | Retail analysts call seller/reviews to get seller FEEDBACK reviews (rating/text/rater/date) by seller_id. | seller_id, marketplace |
| deals | Amazon deal-products (today's deals / goldbox): asin/title/price/image | Pricing teams call deals to get amazon deal-products (today's deals / goldbox). | marketplace |
| product/related | Amazon related & recommended products by ASIN — the product-recommendation carousels from the Amazon product page grouped by relationship: 'Customers who viewed this item also viewed', 'Customers also bought', 'Products related to this item' and 'Frequently bought together'. Each recommended product comes with its ASIN, title, price, star rating and image — ideal for building 'you may also like' / cross-sell feeds. | Marketplace operators call product/related to get amazon related & recommended products by ASIN. | asin, marketplace |
| gtin-to-asin | Amazon barcode lookup — convert a product barcode (UPC, EAN, ISBN or GTIN) into the matching Amazon ASIN(s). Pass the 8-14 digit code from a physical product and get back the Amazon listing(s) it maps to (ASIN, title, price, rating, image) — for catalog matching, price checks and reconciling SKUs to Amazon products. | Catalog enrichment teams call gtin-to-asin to get amazon barcode lookup. | gtin, marketplace, verify |
Call search from your stack
curl -X POST https://api.reefapi.com/amazon/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"laptop"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/amazon/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "laptop"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/amazon/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "laptop"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.amazon.search with {"query":"laptop"}.Who uses this API and why
- Pricing teams call product/offers to monitor the buy-box winner and third-party prices for an ASIN.
- Catalog-enrichment tools use product/detail to fill product pages with images, specs and A+ content.
- Review-analysis products pull product/reviews to track sentiment and rating trends over time.
Questions developers ask before integrating
Which Amazon marketplaces does the Amazon API cover?
23: United States, United Kingdom, Germany, France, Italy, Spain, Netherlands, Belgium, Ireland, Sweden, Poland, Türkiye, United Arab Emirates, Saudi Arabia, Egypt, India, Japan, Singapore, Australia, Canada, Mexico, Brazil and South Africa. Every action (search, product/detail, products_batch, offers, related, reviews, browse, bestsellers, new-releases, autocomplete, deals, seller/profile, seller/products, seller/reviews, gtin-to-asin) answered in all 23 when measured on 2026-11-16, each price in that marketplace's own currency.
Does it work for amazon.ie, amazon.co.za, amazon.com.be and amazon.eg?
Yes. Ireland (EUR), South Africa (ZAR), Belgium (EUR) and Egypt (EGP) return their own site's prices: the same product B0BTYCRJSS came back at €15.90 on amazon.ie, R299 on amazon.co.za, €17.99 on amazon.com.be and EGP 1,046 on amazon.eg. Pass marketplace as ie, co.za (or za), com.be (or be) and eg. amazon.co.za is the slowest marketplace: a search can take up to about a minute.
How do I get an ISO currency code instead of the symbol?
Read currency_code: USD, GBP, EUR, SEK, PLN, TRY, AED, SAR, EGP, INR, JPY, SGD, AUD, CAD, MXN, BRL or ZAR. currency keeps the symbol exactly as Amazon prints it ($, £, €, ¥, ₹, R$, TL, zł, kr, AED), which is ambiguous on its own: "$" is USD on amazon.com and MXN on amazon.com.mx.
Why is currency "$" instead of "USD"?
Because it is read from the page, where Amazon prints a symbol. Measured values are $, £, €, the fullwidth ¥, ₹, R$, and the word-like TL, zł, kr and AED. Two consequences: it is not an ISO code, so do not hand it to a currency library unmapped, and it is not unique - amazon.com and amazon.com.mx both return "$" for very different amounts (a laptop at 4999 on com.mx is pesos). Derive your own currency from meta.marketplace, which every response echoes, and use currency only for display.
Is an ASIN always 10 characters?
Every ASIN measured was exactly 10 uppercase alphanumeric characters - B0DGHMNQ5Z, B01GJOMWVA, B0CKM9F15Z - and parent ids follow the same shape (B0GGJGSPPP, B0F15CGHY5). It is the code after /dp/ in a product URL. If all you have is a barcode, gtin-to-asin converts a UPC, EAN, ISBN or GTIN-14 into the matching ASIN or ASINs rather than making you guess.
Why does products_batch report a much smaller rating_count than product/detail?
products_batch reads Amazon's compact card, where the review count is abbreviated, and it passes that number through unchanged. Measured on the same two ASINs on 2026-08-26: batch returned rating_count 34 where product/detail returned 34,056, and 501 where detail returned 50,194. The star rating itself agrees (4.5 and 4.4). Use products_batch for cheap price and availability refreshes - one upstream call covers up to 15 ASINs - and read rating_count from product/detail whenever the exact number matters.
Why did my parent ASIN come back in not_found?
Because a parent ASIN is a grouping node, not a buyable listing, and Amazon does not serve it as a product page. A measured batch of four returned two products plus not_found ["B0ZZZZZZZZ", "B0GGJGSPPP"] - the first is nonsense, the second is the legitimate parent of the AirPods listing. Query a child ASIN instead. not_found is why the batch action is safe to run blind: nothing is silently dropped, and meta.batch reports requested, resolved, not_found and the ceiling of 15.
How do variations and the parent ASIN relate?
product/detail returns a variations object that maps the whole family in one call: total_children, parent_asin, dimensions (the axes, e.g. style_name and configuration), dimension_values (the options on each axis), asin_map (child ASIN to its option labels) and asin_dimensions (child ASIN to a keyed object). A measured AirPods 4 listing returned 4 children across two axes - Active Noise Cancellation yes/no crossed with AppleCare+ yes/no - under parent B0GGJGSPPP. So you can enumerate every variant with one detail call, then price only the children you care about.
How do the buy box and the third-party offers differ, and where is the seller name?
product/offers returns pinned (the offer Amazon is featuring) as a sibling of offers[] (everything else), and offer_count counts only the latter - a measured call returned meta.record_count 10 for 1 pinned plus 9 offers. Read the merchant from ships_from, which carried real storefront names like "VR Top Sell" and "D' Lolas House"; the seller field currently returns the row label rather than the name. Expect pinned and product/detail to disagree on price - the same ASIN measured 129.00 pinned against 99.00 on the detail page - so capture both rather than assuming either is the price.
What do condition values look like on an offer?
They are Amazon's own English grade strings, not a numeric enum: "New", and for used stock "Used - Like New", "Used - Very Good", "Used - Good" and "Used - Acceptable", all measured on live listings. delivery is a free-text promise line that includes Prime alternatives and an order-within countdown, so treat it as display copy rather than a date. Because offers[] mixes new and used, filter on condition before you compute a lowest price - the cheapest row on one measured ASIN was a used unit at 20.39 against a 34.99 new pinned price.
Why do review bodies start with "Brief content visible, double tap to read full content"?
That is Amazon's own screen-reader text, rendered inside the review block on the product page, and it is returned verbatim rather than being silently edited away. Strip that prefix and its "Full content visible, double tap to read brief content" twin before running sentiment analysis. The rest of the row is clean: review_id, author, profile_id, rating as a float, date as a localized long date ("August 18, 2026"), location, verified, format naming the variant bought, helpful_count and marketplace. Note also that product/detail returns reviews[] as a sibling of product, not nested inside it.
Why do amazon.com reviews say marketplace amazon.ca or amazon.co.uk?
Since 2026-11-13 amazon.com shows "Sign in to see customer reviews" instead of the review list to signed-out visitors, and Amazon's full review pages ask for sign-in on every Amazon site. For an amazon.com request, product/reviews therefore reads the same ASIN's top reviews on amazon.ca, then amazon.co.uk, then amazon.de, and stops at the first site that shows them; most of those reviews are marked "Reviewed in the United States". The response says so: reviews_scope is "top_reviews", login_walled_marketplaces lists the site that asked for sign-in, fallback_marketplaces the site the rows came from, and total_review_count and average_rating remain amazon.com's own figures. If none of the three lists the product's reviews, the call fails with TARGET_BLOCKED and retryable false.
Which fields come back null when Amazon does not print them?
Barcodes and rich content are the usual blanks. On a measured mainstream ASIN, gtin, upc, ean and isbn were all null with barcodes an empty array, aplus was null, categories was empty, and coupon and campaign were null because that listing had no clippable coupon or deal ribbon. availability is null on a normally stocked card by design - Amazon only prints a stock line when stock is low or gone, and the engine does not invent one. Absent means "Amazon did not print it", never "zero".
What is the Amazon API?
Amazon API is a ReefAPI endpoint group for product details, prices, ratings and reviews. It returns live JSON through POST requests under /amazon/v1.