docs / amazon

Amazon

Product details, prices, ratings and reviews.

base /amazon/v113 endpoints

post/amazon/v1/product/detail2 credits

full product page (title/price/currency/rating/count/brand/features/images/categories/variations) + top-8 inline reviews, by ASIN

Parameter		Allowed / range	Description
asin	required	—	Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/product/reviews1 credit

Amazon product reviews by ASIN — returns inline reviews with author, rating, title, date, and verified status. Pass multiple marketplaces (e.g. com, co.uk, de) to merge and deduplicate reviews across Amazon sites for greater depth.

Parameter		Allowed / range	Description
asin	required	—	Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.
marketplaces	optional	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	Merge + dedup reviews from several Amazon sites in one call (more depth than any single site). Overrides `marketplace`. Sites beyond the 19 listed are also accepted.

Try in playground →

post/amazon/v1/product/offers2 credits

pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN

Parameter		Allowed / range	Description
asin	required	—	Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/search1 credit

product search → results[]{asin,title,price,currency,rating,count,image,sponsored}

Parameter		Allowed / range	Description
query	required	—	What to search for (product keywords).
sort = relevanceblender	optional	relevanceblender · price-asc-rank · price-desc-rank · review-rank · date-desc-rank · exact-aware-popularity-rank	Result ordering (the 6 listed are the live-verified Amazon sort keys; an unknown value falls back to Featured upstream).
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.
page = 1	optional	1–	Page number (easy paging: 1, 2, 3…).

Try in playground →

post/amazon/v1/bestsellers1 credit

best-sellers ranking (optionally by category)

Parameter		Allowed / range	Description
category	optional	—	Department slug from the bestsellers URL (amazon.com/gp/bestsellers/<slug>). Verified slugs: electronics, books, toys-and-games, beauty, videogames, fashion, sporting-goods. Leave empty for all departments; an unknown slug returns 0 items.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/new-releases1 credit

new-releases ranking (optionally by category)

Parameter		Allowed / range	Description
category	optional	—	Department slug from the bestsellers URL (amazon.com/gp/bestsellers/<slug>). Verified slugs: electronics, books, toys-and-games, beauty, videogames, fashion, sporting-goods. Leave empty for all departments; an unknown slug returns 0 items.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/seller/profile1 credit

seller profile (name, feedback %, lifetime ratings, rating)

Parameter		Allowed / range	Description
seller_id	required	—	Amazon seller ID — the code after seller= in a seller-page URL.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/autocompletefree

search autocomplete suggestions

Parameter		Allowed / range	Description
query	required	—	Partial search text to complete (e.g. 'lapt' → laptop…).
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/seller/products1 credit

a seller's catalog/storefront by seller_id (paginated)

Parameter		Allowed / range	Description
seller_id	required	—	Amazon seller ID — the code after seller= in a seller-page URL.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.
page = 1	optional	1–	Page number (easy paging: 1, 2, 3…).

Try in playground →

post/amazon/v1/seller/reviews1 credit

seller FEEDBACK reviews (rating/text/rater/date) by seller_id (paginated)

Parameter		Allowed / range	Description
seller_id	required	—	Amazon seller ID — the code after seller= in a seller-page URL.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.
page = 1	optional	1–	Page number (easy paging: 1, 2, 3…).

Try in playground →

post/amazon/v1/deals1 credit

Amazon deal-products (today's deals / goldbox): asin/title/price/image

Parameter		Allowed / range	Description
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/product/related1 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.

Parameter		Allowed / range	Description
asin	required	—	Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

post/amazon/v1/gtin-to-asin1 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.

Parameter		Allowed / range	Description
gtin	optional	—	The product barcode to look up — a UPC (12 digits), EAN (13), ISBN-10/13 or GTIN-14. Hyphens/spaces are ignored.
marketplace = com	optional	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	Which Amazon site to query (sets language and currency). Dropdown = the 19 verified marketplaces; other Amazon sites (e.g. eg, com.be) and forms like 'amazon.de'/'DE' are also accepted and normalized by the engine.

Try in playground →

Example request · product/detail

curl -X POST https://api.reefapi.com/amazon/v1/product/detail \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"asin":"0735211299"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}