Amazon API
The Amazon Product Data API returns product, review, offer and search data across Amazon marketplaces as clean JSON.
🤖 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.
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": 2983.7,
"record_count": 16,
"bytes": 1612023,
"cache_hit": false,
"completeness_pct": 100,
"marketplace": "com",
"pagination": {
"page": 1,
"has_more": true
}
},
"data": {
"results": [
{
"asin": "B0GQB1LPTR",
"title": "HP OmniBook 3 17.3 inch Laptop PC, FHD Display, AMD Ryzen 3 30, 8 GB RAM, 512 GB SSD, AMD Radeon 610M Graphics, Windows 11 Home, Mica Silver, 17-dp0199nr",
"price": 449.99,
"currency": "$",
"rating": 4.4,
"rating_count": 87,
"image": "https://m.media-amazon.com/images/I/71qW8R8vytL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": "Ends in"
},
{
"asin": "B0H5QC6QW4",
"title": "15.6 Inch Laptop with AI, Office 365, 6GB RAM 128GB SSD, Quad-Core Processor, Win 11 Home Laptops Computer, IPS FHD, 180°Viewing, Type-C, WiFi 5, BT4.2, Portable Thin Laptops - Gray",
"price": 259.99,
"currency": "$",
"rating": 4.4,
"rating_count": 18,
"image": "https://m.media-amazon.com/images/I/81LNJ0I6sFL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": "Limited time deal"
},
{
"asin": "B0GRPWC7HK",
"title": "HP 14” Laptop Ultra-Portable Computer 2026 Student Business, MS Office, Copilot AI, Intel 4-Core CPU, 4GB RAM, 628GB Storage (128GB UFS+500GB Ext), Long Battery, MaxsolAccessory, Win 11 Pro, Lavender",
"price": 269.1,
"currency": "$",
"rating": 4.3,
"rating_count": 32,
"image": "https://m.media-amazon.com/images/I/71m6yX1hUPL._AC_UY218_.jpg",
"sponsored": false,
"coupon": null,
"campaign": "Limited time deal"
}
],
"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 |
| product/reviews | Amazon product reviews by ASIN — the public reviews from the product page (and optionally merged + deduped across several marketplaces for more depth). Each review has author, rating, title, date, body, verified badge and helpful votes. | 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,count,image,sponsored} | Retail analysts call search to get product search with optional filters (price range, minimum rating, deals, brand) → results[]{…. | query, marketplace, page, sort, price_min, ... |
| bestsellers | best-sellers ranking for a department (category slug required) | Pricing teams call bestsellers to get best-sellers ranking for a department (category slug required). | category, marketplace |
| new-releases | new-releases ranking for a department (category slug required) | Marketplace operators call new-releases to get new-releases ranking for a department (category slug required). | category, marketplace |
| seller/profile | seller profile (name, feedback %, lifetime ratings, rating) | Catalog enrichment teams call seller/profile to get seller profile (name, feedback %, lifetime ratings, rating). | seller_id, marketplace |
| autocomplete | search autocomplete suggestions | Retail analysts call autocomplete to search autocomplete suggestions. | query, marketplace |
| seller/products | a seller's catalog/storefront by seller_id (paginated) | Pricing 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 | Marketplace operators 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 | Catalog enrichment 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. | Retail analysts 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. | Pricing teams call gtin-to-asin to get amazon barcode lookup. | gtin, marketplace |
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 requests
r = requests.post(
"https://api.reefapi.com/amazon/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "laptop"
},
)
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
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.
Is the Amazon API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Amazon calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Amazon login or account?
No login to Amazon is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Amazon data?
The page example is captured from a live product/detail call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Amazon API use?
Amazon actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Amazon from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call amazon actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Amazon API a Amazon scraper?
It is the managed alternative to a DIY Amazon scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same product details, prices, ratings and reviews back as clean JSON.
Why does my Amazon scraper keep getting blocked?
Most Amazon scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.