{"openapi":"3.0.3","info":{"title":"Amazon Product API (ReefAPI)","version":"0.1.5","description":"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) Call POST /amazon/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.","contact":{"name":"ReefAPI","url":"https://reefapi.com/amazon-api","email":"support@reefapi.com"},"license":{"name":"ReefAPI Terms","url":"https://reefapi.com/terms"},"termsOfService":"https://reefapi.com/terms"},"externalDocs":{"description":"Amazon Product API documentation","url":"https://reefapi.com/docs/amazon"},"servers":[{"url":"https://api.reefapi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"amazon","description":"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)"}],"paths":{"/amazon/v1/product/detail":{"post":{"operationId":"amazon_product_detail","summary":"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","description":"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","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","example":"B0DGHMNQ5Z","description":"Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/amazon/v1/product/reviews":{"post":{"operationId":"amazon_product_reviews","summary":"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), o","description":"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.","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","example":"B0DGHMNQ5Z","description":"Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."},"marketplaces":{"type":"array","items":{"type":"string","enum":["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"]},"example":["com","co.uk","de"],"description":"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."}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/product/offers":{"post":{"operationId":"amazon_product_offers","summary":"pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN","description":"pinned buybox + all-offers (AOD aodAjaxMain): price/seller/condition/ships_from/delivery/prime, by ASIN","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","example":"B0DGHMNQ5Z","description":"Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["asin"]},"example":{"asin":"B0DGHMNQ5Z"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":2}},"/amazon/v1/search":{"post":{"operationId":"amazon_search","summary":"product search with optional filters (price range, minimum rating, deals, brand) → results[]{asin,title,price,currency,rating,rating_count,image,sponsored,url}","description":"product search with optional filters (price range, minimum rating, deals, brand) → results[]{asin,title,price,currency,rating,rating_count,image,sponsored,url}","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"laptop","description":"What to search for (product keywords)."},"sort":{"type":"string","enum":["relevanceblender","price-asc-rank","price-desc-rank","review-rank","date-desc-rank","exact-aware-popularity-rank"],"default":"relevanceblender","description":"Result ordering (the 6 listed are the live-verified Amazon sort keys; an unknown value falls back to Featured upstream)."},"price_min":{"type":"integer","minimum":0,"example":100,"description":"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":{"type":"integer","minimum":0,"example":300,"description":"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":{"type":"integer","enum":[1,2,3,4],"example":4,"description":"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."},"deals":{"type":"boolean","default":false,"description":"When true, restrict to products with an active Amazon deal (Today's Deals). Live-verified on the US site."},"discount":{"type":"boolean","default":false,"description":"Alias of `deals` — restrict to discounted/on-deal products."},"prime":{"type":"boolean","default":false,"description":"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":{"type":"string","example":"HP","description":"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":{"type":"string","example":"Nike","description":"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":{"type":"string","enum":["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"],"default":"com","description":"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."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number (easy paging: 1, 2, 3…)."},"max_results":{"type":"integer","minimum":1,"maximum":336,"example":100,"description":"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."}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/products_batch":{"post":{"operationId":"amazon_products_batch","summary":"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","description":"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.","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asins":{"type":"array","items":{"type":"string"},"example":["B0DGHMNQ5Z","B01GJOMWVA","B0CKM9F15Z"],"description":"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":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["asins"]},"example":{"asins":["B0DGHMNQ5Z","B01GJOMWVA","B0CKM9F15Z"]}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":10}},"/amazon/v1/category/browse":{"post":{"operationId":"amazon_category_browse","summary":"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 eve","description":"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.","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"node":{"type":"string","example":"172282","description":"Amazon browse node id (the number in a category URL after `node=`). 172282 = Electronics on .com."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number (easy paging: 1, 2, 3…)."}},"required":["node"]},"example":{"node":"172282"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/bestsellers":{"post":{"operationId":"amazon_bestsellers","summary":"best-sellers ranking for a department (category slug required)","description":"best-sellers ranking for a department (category slug required)","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["appliances","automotive","beauty","books","fashion","gift-cards","grocery","handmade","industrial","kitchen","music","musical-instruments","pet-supplies","software","videogames"],"example":"electronics","description":"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."},"max_results":{"type":"integer","minimum":1,"maximum":100,"default":30,"example":100,"description":"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":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["category"]},"example":{"category":"electronics","max_results":30}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/new-releases":{"post":{"operationId":"amazon_new_releases","summary":"new-releases ranking for a department (category slug required)","description":"new-releases ranking for a department (category slug required)","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"category":{"type":"string","enum":["appliances","automotive","beauty","books","fashion","gift-cards","grocery","handmade","industrial","kitchen","music","musical-instruments","pet-supplies","software","videogames"],"example":"electronics","description":"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."},"max_results":{"type":"integer","minimum":1,"maximum":100,"default":30,"example":100,"description":"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":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["category"]},"example":{"category":"electronics"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/seller/profile":{"post":{"operationId":"amazon_seller_profile","summary":"seller profile (name, feedback %, lifetime ratings, rating)","description":"seller profile (name, feedback %, lifetime ratings, rating)","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string","example":"A3A9OGKM04K3X0","description":"Amazon seller ID — the code after seller= in a seller-page URL."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/autocomplete":{"post":{"operationId":"amazon_autocomplete","summary":"search autocomplete suggestions","description":"search autocomplete suggestions","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","example":"lapt","description":"Partial search text to complete (e.g. 'lapt' → laptop…)."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["query"]},"example":{"query":"laptop"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/seller/products":{"post":{"operationId":"amazon_seller_products","summary":"a seller's catalog/storefront by seller_id (paginated)","description":"a seller's catalog/storefront by seller_id (paginated)","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string","example":"A3A9OGKM04K3X0","description":"Amazon seller ID — the code after seller= in a seller-page URL."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."},"page":{"type":"integer","minimum":1,"default":1,"description":"Page number (easy paging: 1, 2, 3…)."}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/seller/reviews":{"post":{"operationId":"amazon_seller_reviews","summary":"seller FEEDBACK reviews (rating/text/rater/date) by seller_id","description":"seller FEEDBACK reviews (rating/text/rater/date) by seller_id","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"seller_id":{"type":"string","example":"A3A9OGKM04K3X0","description":"Amazon seller ID — the code after seller= in a seller-page URL."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["seller_id"]},"example":{"seller_id":"A3A9OGKM04K3X0"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/deals":{"post":{"operationId":"amazon_deals","summary":"Amazon deal-products (today's deals / goldbox): asin/title/price/image","description":"Amazon deal-products (today's deals / goldbox): asin/title/price/image","tags":["amazon"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}}}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/product/related":{"post":{"operationId":"amazon_product_related","summary":"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","description":"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.","tags":["amazon"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"asin":{"type":"string","example":"B0DGHMNQ5Z","description":"Amazon product ID (ASIN) — the 10-character code in the product URL after /dp/."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."}},"required":["asin"]},"example":{"asin":"0735211299"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}},"/amazon/v1/gtin-to-asin":{"post":{"operationId":"amazon_gtin_to_asin","summary":"Amazon barcode lookup — convert a product barcode (UPC, EAN, ISBN or GTIN) into the matching Amazon ASIN(s)","description":"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.","tags":["amazon"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"gtin":{"type":"string","example":"9780735211292","description":"The product barcode to look up — a UPC (12 digits), EAN (13), ISBN-10/13 or GTIN-14. Hyphens/spaces are ignored."},"marketplace":{"type":"string","enum":["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"],"default":"com","description":"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."},"verify":{"type":"boolean","default":false,"description":"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."}}},"example":{"gtin":"9780735211292"}}}},"responses":{"200":{"description":"Result envelope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"401":{"description":"Missing or invalid x-api-key"},"429":{"description":"Rate limited or quota exhausted"}},"x-reefapi-credits":1}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"Envelope":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean"},"data":{"description":"Action result (shape varies per action)"},"meta":{"type":"object","description":"api, endpoint, mode, latency_ms, record_count, completeness_pct"},"error":{"type":"object","nullable":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"}}}}}}}}