# Amazon Product Data API — product detail, reviews, offers, search, best-sellers, and seller data across 23 Amazon marketplaces (amazon.com, .co.uk, .de, .co.jp and more)

> 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
> ReefAPI engine `amazon` · 15 endpoints · clean JSON, no scraping or browsers to manage.

## Measured
- Amazon API, measured on live customer calls 17 Oct – 16 Nov 2026: 99.7% of calls succeeded, median response 3.4 s. Failures count only when the problem is ours (blocked, source error, parse error, timeout); not-found results and invalid parameters are not failures.
- OpenAPI 3.0 spec for this API: https://api.reefapi.com/openapi/amazon.json

## How to call
- **Endpoint:** `POST https://api.reefapi.com/amazon/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/amazon/v1/product/detail — 2 credits
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

**Parameters:**
- `asin` (string, required) — Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** product{asin, title, price, currency, currency_code (ISO-4217, derived from the marketplace rather than the symbol — '$' is four different currencies), list_price (the struck-through LIST price only — null when the page publishes none; never the per-unit price ('$0.24 / load'), never the Subscribe&Save 'one-time' price and never the used-buybox 'new condition' price, all three of which Amazon renders with the same CSS class), rating, brand (the brand as Amazon lists it in the product-overview table — for books, the primary author; read from markup that is the same in every marketplace, so a .de/.fr page returns 'soundcore', not the localized 'Visit the Store' link text), features[], images[], in_stock (normalised boolean; null only when the page says nothing AND carries no purchasable price), color, size (this ASIN's own variant values, lifted out of the variation map), parent_asin, attributes{weight{value,unit,grams,raw,key}, dimensions{length,width,height,depth,thickness,unit,axis_count,format,raw,key}, bsr[]{rank,category,is_primary}, model_number, part_number, manufacturer, first_available_raw, _source{}} — the TYPED form of tech_specs: weight arrives as a number in grams instead of a localized string like '4,5 Pfund', and `raw` is always kept. Unknown unit means grams is null, never guessed, asin_mismatch + served_asin (true when Amazon served a different member of the variation family than the ASIN you asked for — previously invisible; no field is removed when it is true), buybox_seller, fulfillment ('amazon' | 'merchant' | null), delivery_message, discount_pct, bought_past_month (+_raw), rating_histogram{5..1 as percentages}, description, variations, tech_specs{key:value}, aplus{images[],headings[],text}, compare_similar[]{asin,title,price,rating,image}, coupon (clippable coupon label e.g. '%10 kuponunu uygula', null when none), campaign (deal-badge ribbon e.g. 'Fırsat' / '90 günün en düşük fiyatı', null when none), gtin (GTIN-14, zero-padded from the printed UPC/EAN when Amazon prints only that — the inverse of product/gtin-to-asin), upc, ean, isbn, barcodes[] (every distinct code on the page; multipack listings print more than one) — all null when Amazon prints no barcode for this ASIN} + reviews[]{review_id,author,rating,title,date,location,verified,format,helpful_count,body,images[],marketplace} (top-8 inline, SIBLING of `product`, not nested inside it) + review_insights{summary, aspects[]{keyword,sentiment,positive,negative,mentions,mentions_positive_pct}, quotes[]{text,review_id,aspect}} (Amazon 'Customers say' AI review summary; null when the product has none) + total_review_count + average_rating

**Example request body:**
```json
{
  "asin": "B0DGHMNQ5Z"
}
```

### POST https://api.reefapi.com/amazon/v1/product/reviews — 1 credit
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.

**Parameters:**
- `asin` (string, required) — Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]
- `marketplaces` (array, optional) — Merge + dedup reviews from several Amazon sites in one call (more depth than any single site). Overrides `marketplace`. Sites beyond the 23 listed are also accepted. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** reviews[]{author, rating, title, date, location, verified, body, helpful_count, marketplace} + returned_count + total_review_count + average_rating + review_insights{summary, aspects[]{keyword,sentiment,positive,negative,mentions,mentions_positive_pct}, quotes[]{text,review_id,aspect}} (Amazon 'Customers say' AI review summary; null when absent) + reviews_scope ('top_reviews') + login_walled_marketplaces[] (sites that asked for sign-in instead of showing reviews) + fallback_marketplaces[] (sites the reviews were read from instead). total_review_count and average_rating are the requested site's own figures.

**Example request body:**
```json
{
  "asin": "B0DGHMNQ5Z"
}
```

### POST https://api.reefapi.com/amazon/v1/product/offers — 2 credits
pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN

**Parameters:**
- `asin` (string, required) — Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** pinned{price (the price you actually pay), total_price, unit_price, unit_count, unit_label, currency, currency_code, seller (the seller's NAME), condition, prime} + offers[]{same shape, plus ships_from and delivery} + offer_count. On multi-packs Amazon prints a per-unit price next to the pack price; both are returned separately and typed, so a '$4.20 per pack' next to a $20.99 pack can never be mistaken for the total.

**Example request body:**
```json
{
  "asin": "B0DGHMNQ5Z"
}
```

### POST https://api.reefapi.com/amazon/v1/search — 1 credit
product search with optional filters (price range, minimum rating, deals, brand) → results[]{asin,title,price,currency,rating,rating_count,image,sponsored,url}

**Parameters:**
- `query` (string, required) — What to search for (product keywords).
- `sort` (enum, optional, default "relevanceblender") — Result ordering (the 6 listed are the live-verified Amazon sort keys; an unknown value falls back to Featured upstream). [one of: relevanceblender, price-asc-rank, price-desc-rank, review-rank, date-desc-rank, exact-aware-popularity-rank]
- `price_min` (integer, optional) — Minimum price filter, in whole units of the marketplace currency (e.g. 100 = $100 on amazon.com). Combine with price_max for a range.
- `price_max` (integer, optional) — Maximum price filter, in whole units of the marketplace currency (e.g. 300 = $300 on amazon.com). Use with price_min for a range.
- `min_rating` (integer, optional) — Keep only products rated this many stars and up (1-4). 4 = '4 stars & up' is live-verified; lower tiers are best-effort and only the US site (marketplace=com) is verified. [one of: 1, 2, 3, 4]
- `deals` (boolean, optional, default false) — When true, restrict to products with an active Amazon deal (Today's Deals). Live-verified on the US site.
- `discount` (boolean, optional, default false) — Alias of `deals` — restrict to discounted/on-deal products.
- `prime` (boolean, optional, default false) — When true, attempt to restrict to Prime-eligible items. BEST-EFFORT: Amazon no longer exposes a reliable Prime URL refinement, so this may be a no-op on some sites/queries.
- `brand` (string, optional) — Filter to a brand. BEST-EFFORT: passed as a keyword refinement (the brand is appended to the query) rather than a strict brand facet, so results are brand-narrowed but not brand-exclusive.
- `brand_exact` (string, optional) — Filter to a brand STRICTLY, using Amazon's own brand refinement rather than a keyword. Use this when you need a brand-narrowed result set; use `brand` when you would rather keep near-matches. Measured on `running shoes`: unfiltered 5 of 48 rows were the brand, `brand` gave 46 of 48, `brand_exact` gave 48 of 48 per page and held at 100% on pages 1-3. HONEST LIMIT: on the page variant where Amazon returns 60 cards instead of 48 it pads the tail with related products (measured once in four runs: 51 of 60), so filter client-side if you need a hard guarantee. Both params may be sent together; `brand` is unchanged and keeps its old behaviour.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]
- `page` (integer, optional, default 1) — Page number (easy paging: 1, 2, 3…).
- `max_results` (integer, optional) — How many products to return (1-336). Amazon's page size depends on the query (measured: 48 products a page for 'coffee maker', 16 for 'laptop'), and asking for more than one page's worth fetches the further pages automatically — they are fetched TOGETHER, so 200 results cost roughly the time of one page, not four. 336 is Amazon's own ceiling: it stops serving results after page 7 (measured on every query tried), so there is nothing above 336 to return, and a query whose pages are small tops out sooner — ask for more than exists and you simply get everything there is. Amazon repeats some sponsored cards across pages and those duplicates are removed, so a narrow query can run out of DISTINCT products before the number you asked for: when that happens the response says so in `meta.pagination` (`requested`, `returned`, `shortfall`, `note`) and `meta.stop_reason` is `page_ceiling`/`exhausted`/`pages_failed` rather than `complete` — a short answer is never reported as a full one. OMIT IT to get exactly one page, byte-for-byte the behaviour you get today — `page` on its own is completely unchanged.

**Returns:** results[]{asin, title (the full listing title - the same text product/detail returns; never the brand line Amazon prints above it, null only when the card carries no readable title), brand (the brand line Amazon prints on the card, null when the card has none), price, currency, rating (average stars as the card prints them, in every marketplace language; NULL only when the product has no ratings yet — measured 22 of 364 rows across 12 marketplace/query samples, and each of those cards carries no star widget at all), rating_count, image, sponsored (the product title is the real title on sponsored rows too — the ad disclaimer is stripped), currency_code, in_stock (normalised boolean; a card with a purchasable price is in stock because Amazon only prints one when a featured offer exists, and null when neither a stock line nor a price is present), coupon (clippable coupon label, null when none), campaign (deal-badge ribbon e.g. 'Fırsat', null when none), availability (stock line as Amazon words it on the card — same vocabulary as product/detail, e.g. 'Only 4 left in stock - order soon.' / 'No featured offers available'; NULL on a normally-stocked card because Amazon only renders the line for low/no stock — it is never inferred), format (the card's own format as Amazon prints it, e.g. 'MP3 Music', 'Vinyl', 'Paperback', 'Kindle', 'Prime Video'; null when the card prints none), product_class ('digital_media' when the card is Amazon Digital Music, which product/detail answers with NOT_FOUND and the same error.detail.product_class, so you can skip that call; null otherwise — Kindle, Prime Video and Audible have detail pages and stay null), url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)} + page + filters_applied (meta.pagination for paging)

**Example request body:**
```json
{
  "query": "laptop"
}
```

### POST https://api.reefapi.com/amazon/v1/products_batch — 10 credits
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.

**Parameters:**
- `asins` (array, required) — Amazon ASINs to look up — up to 15 per call. Accepts a list, or a comma-separated string. Anything Amazon does not return comes back in `not_found` rather than being silently dropped, so a caller batching 15 can always tell which one went missing.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** products[]{asin, title, price, currency, currency_code, rating, rating_count, image, sponsored, coupon, campaign, availability, in_stock, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)} + not_found[] (ASINs Amazon did not return — reported, never silently dropped) + requested + resolved

**Example request body:**
```json
{
  "asins": [
    "B0DGHMNQ5Z",
    "B01GJOMWVA",
    "B0CKM9F15Z"
  ]
}
```

### POST https://api.reefapi.com/amazon/v1/category/browse — 1 credit
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.

**Parameters:**
- `node` (string, required) — Amazon browse node id (the number in a category URL after `node=`). 172282 = Electronics on .com.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]
- `page` (integer, optional, default 1) — Page number (easy paging: 1, 2, 3…).

**Returns:** results[]{asin, title, brand, price, currency, currency_code, rating, rating_count, image, in_stock, sponsored, coupon, campaign, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)} + node + page + has_next

**Example request body:**
```json
{
  "node": "172282"
}
```

### POST https://api.reefapi.com/amazon/v1/bestsellers — 1 credit
best-sellers ranking for a department (category slug required)

**Parameters:**
- `category` (string, required) — Department slug from the bestsellers URL (amazon.com/gp/bestsellers/<slug>). REQUIRED — the all-departments root page is not server-rendered, so a department is needed to get a ranking. THE SLUGS DIFFER PER MARKETPLACE: amazon.com has no `garden` (use `home-garden` or `lawn-garden`) and amazon.de has no `electronics`, `sporting-goods` or `toys-and-games` (use `ce-de`, `sports`, `toys`). The dropdown lists the 15 slugs measured to work on amazon.com/.de/.fr/.co.uk/.it/.es alike; marketplace-specific slugs work too. A slug that is not a department on the marketplace you asked for returns INVALID_PARAM listing the slugs measured to work there — never an empty list. [one of: appliances, automotive, beauty, books, fashion, gift-cards, grocery, handmade, industrial, kitchen, music, musical-instruments, pet-supplies, software, videogames]
- `max_results` (integer, optional, default 30) — How many ranked items to return (1-100). Amazon serves ~30 per page of a best-sellers / new-releases list and the list itself runs to 100, so asking for more than 30 fetches the further pages automatically — one upstream page per credit, about 30 items each. That makes this the cheapest discovery shape on this engine: `search` pages at roughly 15 products per upstream page. Paging stops the moment a page adds nothing new, so a short list never pays for empty pages, and `meta.pages_ok` always says how many pages actually answered.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** items[]{rank, asin, title (FULL title — this used to be cut at ~124 characters), price, currency_code, rating, image, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)}

**Example request body:**
```json
{
  "category": "electronics",
  "max_results": 30
}
```

### POST https://api.reefapi.com/amazon/v1/new-releases — 1 credit
new-releases ranking for a department (category slug required)

**Parameters:**
- `category` (string, required) — Department slug from the bestsellers URL (amazon.com/gp/bestsellers/<slug>). REQUIRED — the all-departments root page is not server-rendered, so a department is needed to get a ranking. THE SLUGS DIFFER PER MARKETPLACE: amazon.com has no `garden` (use `home-garden` or `lawn-garden`) and amazon.de has no `electronics`, `sporting-goods` or `toys-and-games` (use `ce-de`, `sports`, `toys`). The dropdown lists the 15 slugs measured to work on amazon.com/.de/.fr/.co.uk/.it/.es alike; marketplace-specific slugs work too. A slug that is not a department on the marketplace you asked for returns INVALID_PARAM listing the slugs measured to work there — never an empty list. [one of: appliances, automotive, beauty, books, fashion, gift-cards, grocery, handmade, industrial, kitchen, music, musical-instruments, pet-supplies, software, videogames]
- `max_results` (integer, optional, default 30) — How many ranked items to return (1-100). Amazon serves ~30 per page of a best-sellers / new-releases list and the list itself runs to 100, so asking for more than 30 fetches the further pages automatically — one upstream page per credit, about 30 items each. That makes this the cheapest discovery shape on this engine: `search` pages at roughly 15 products per upstream page. Paging stops the moment a page adds nothing new, so a short list never pays for empty pages, and `meta.pages_ok` always says how many pages actually answered.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** items[]{rank, asin, title (FULL title — this used to be cut at ~124 characters), price, currency_code, rating, image, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)}

**Example request body:**
```json
{
  "category": "electronics"
}
```

### POST https://api.reefapi.com/amazon/v1/seller/profile — 1 credit
seller profile (name, feedback %, lifetime ratings, rating)

**Parameters:**
- `seller_id` (string, required) — Amazon seller ID — the code after seller= in a seller-page URL.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** seller_name + feedback_positive_pct + lifetime_ratings + rating

**Example request body:**
```json
{
  "seller_id": "A3A9OGKM04K3X0"
}
```

### POST https://api.reefapi.com/amazon/v1/autocomplete — 1 credit
search autocomplete suggestions

**Parameters:**
- `query` (string, required) — Partial search text to complete (e.g. 'lapt' → laptop…).
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** suggestions[] (plain strings)

**Example request body:**
```json
{
  "query": "laptop"
}
```

### POST https://api.reefapi.com/amazon/v1/seller/products — 1 credit
a seller's catalog/storefront by seller_id (paginated)

**Parameters:**
- `seller_id` (string, required) — Amazon seller ID — the code after seller= in a seller-page URL.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]
- `page` (integer, optional, default 1) — Page number (easy paging: 1, 2, 3…).

**Returns:** results[]{asin, title, brand, price, currency, rating, rating_count, image, sponsored, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)} + page (meta.pagination for paging)

**Example request body:**
```json
{
  "seller_id": "A3A9OGKM04K3X0"
}
```

### POST https://api.reefapi.com/amazon/v1/seller/reviews — 1 credit
seller FEEDBACK reviews (rating/text/rater/date) by seller_id

**Parameters:**
- `seller_id` (string, required) — Amazon seller ID — the code after seller= in a seller-page URL.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** reviews[]{rating, text, rater, date} + returned_count

**Example request body:**
```json
{
  "seller_id": "A3A9OGKM04K3X0"
}
```

### POST https://api.reefapi.com/amazon/v1/deals — 1 credit
Amazon deal-products (today's deals / goldbox): asin/title/price/image

**Parameters:**
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** items[]{asin, title (the product name only — the offer text Amazon prints inside the same element, e.g. '20% off Limited time deal $239.99 List: $299.99', is separated out), price, list_price, savings_pct, in_stock, url, image, rating (null on this surface: Amazon does not render stars on a deal card, and we do not invent one)}

### POST https://api.reefapi.com/amazon/v1/product/related — 1 credit
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.

**Parameters:**
- `asin` (string, required) — Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]

**Returns:** asin + groups{<relationship>: items[]} + related[] (flat, deduped) + group_count + item_count; each item{asin, title, price, currency, rating, image, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)}

**Example request body:**
```json
{
  "asin": "0735211299"
}
```

### POST https://api.reefapi.com/amazon/v1/gtin-to-asin — 1 credit
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.

**Parameters:**
- `gtin` (string, optional) — The product barcode to look up — a UPC (12 digits), EAN (13), ISBN-10/13 or GTIN-14. Hyphens/spaces are ignored.
- `marketplace` (enum, optional, default "com") — Which Amazon site to query (sets language and currency). Dropdown = the 23 measured marketplaces; forms like 'amazon.de', 'DE', 'uk', 'us', 'za', 'be' are also accepted and normalized by the engine. [one of: com, co.uk, de, fr, it, es, co.jp, in, ca, com.au, com.mx, com.br, com.tr, ae, nl, se, pl, sg, sa, ie, co.za, com.be, eg]
- `verify` (boolean, optional, default false) — Also open the matched product's own page and check that it prints this barcode (verified=true/false). Adds one product-page fetch, about 3-4 s, and only when there is an organic match. Default false.

**Returns:** gtin + asin (the first ORGANIC search result for the code; null when Amazon shows only sponsored ads, i.e. it has no listing for this barcode) + match_status ('search_match' | 'verified' | 'no_verified_match' | 'sponsored_only' | 'no_results') + verified (bool) + organic_match_count + verify_checked + matches[]{asin, title, brand, price, currency, rating, rating_count, image, sponsored, verified (true | false | null), page_barcodes, url (canonical product link on the marketplace queried, https://www.amazon.<tld>/dp/<ASIN>, no tracking parameters; sponsored rows link the advertised product)} + match_count (all cards, ads included)

**Example request body:**
```json
{
  "gtin": "9780735211292"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=amazon
- Human docs page: https://reefapi.com/docs/amazon
- Overview page: https://reefapi.com/amazon-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
