ReefAPI

ReefAPI E-commerce & Marketplaces API

The E-commerce & Marketplaces API from ReefAPI — 264 operation(s) for e-commerce & marketplaces.

GitHub OpenAPI

Operations 264

Showing the first 250 of 264. The full set is in the contract, and via get_provider_operations.

POST /aliexpress/v1/product_detail Full product + SKU-variant price/stock matrix + specs + images + video + store… #
POST /aliexpress/v1/reviews Buyer reviews (paginated — fetch many pages in one call) + rating distribution #
POST /aliexpress/v1/similar Products similar to a given item (search-backed 'more like this', seed product… #
POST /aliexpress/v1/description Full product description text + images #
POST /aliexpress/v1/shipping Shipping options per destination country #
POST /aliexpress/v1/store_info Store profile (+ live seller metrics when a query is supplied) #
POST /aliexpress/v1/deals SuperDeals / discounted cards (search-derived, sorted by discount) #
POST /allegro/v1/category Browse an Allegro category without a keyword (the /kategoria/ grid) — discover… #
POST /allegro/v1/offer Single Allegro offer/product detail by id or URL — title, price (PLN), main… #
POST /allegro/v1/seller_offers A seller's public active listings, paginated — every offer a seller (shop) has… #
POST /allegro/v1/suggested Related/recommended Allegro offers for a keyword — a quick set of relevant… #
POST /amazon/v1/product/detail full product page (title/price/currency/rating/count/brand/features/images/categ… #
POST /amazon/v1/product/reviews Amazon product reviews by ASIN — the public reviews from the product page (and… #
POST /amazon/v1/product/offers pinned buybox + all-offers (AOD aodAjaxMain)… #
POST /amazon/v1/products_batch Look up MANY Amazon products in ONE call by ASIN — up to 15 per request → each… #
POST /amazon/v1/bestsellers best-sellers ranking for a department (category slug required) #
POST /amazon/v1/new-releases new-releases ranking for a department (category slug required) #
POST /amazon/v1/seller/profile seller profile (name, feedback %, lifetime ratings, rating) #
POST /amazon/v1/autocomplete search autocomplete suggestions #
POST /amazon/v1/seller/products a seller's catalog/storefront by seller_id (paginated) #
POST /amazon/v1/seller/reviews seller FEEDBACK reviews (rating/text/rater/date) by seller_id #
POST /amazon/v1/deals Amazon deal-products (today's deals / goldbox): asin/title/price/image #
POST /amazon/v1/gtin-to-asin Amazon barcode lookup — convert a product barcode (UPC, EAN, ISBN or GTIN) into… #
POST /asos/v1/category Browse all products in a category by category_id, with the same filters… #
POST /asos/v1/sale On-sale / marked-down products only. #
POST /asos/v1/new_in Newest arrivals — freshness-sorted products, optionally limited to a recent… #
POST /asos/v1/product full product detail (sizes/stock/description/images) by product_id or… #
POST /asos/v1/products batch product detail for comma-separated product_ids #
POST /asos/v1/navigation category links from gender landing pages; format=tree returns nested path… #
POST /asos/v1/reviews product reviews + rating summary from PDP embedded ratings blob (paginated) #
POST /asos/v1/similar related products via same-brand search fallback (true mightLike API is… #
POST /asos/v1/filters available search/category facets (brands, colours, sizes, price ranges) #
POST /asos/v1/suggestions search autocomplete suggestions for partial query #
POST /autotrader/v1/listing_detail Full advert (price+priceIndicator+deviation, mileage, full spec… #
POST /bestbuy/v1/product_detail Get the full product card for one Best Buy item by its product number, URL, or… #
POST /bestbuy/v1/products_batch Look up MANY Best Buy products in ONE call by product number — up to 15 per… #
POST /bestbuy/v1/reviews Get customer reviews for a Best Buy product → each review's star rating, title… #
POST /bestbuy/v1/review_summary Get the review snapshot for a Best Buy product → average rating, total review… #
POST /bestbuy/v1/search_suggestions Get Best Buy search autocomplete suggestions for a partial query → the… #
POST /bestbuy/v1/price Get the live pricing for a Best Buy product by SKU → current price, regular… #
POST /bestbuy/v1/gifts Get the Gift-With-Purchase offers for a Best Buy product by SKU → each… #
POST /bestbuy/v1/description Get a Best Buy product's full description and complete technical specifications… #
POST /bestbuy/v1/deals Browse Best Buy's current deals — on-sale and clearance products site-wide… #
POST /bestbuy/v1/qa Get the customer questions & answers for a Best Buy product → each question… #
POST /bestbuy/v1/store_availability Check whether a Best Buy product (by SKU) is available to buy for a given ZIP… #
POST /bestbuy/v1/categories Discover the categories and filter facets available for a Best Buy keyword… #
POST /chrono24/v1/browse Browse all listings for a brand (e.g. #
POST /chrono24/v1/detail Full watch listing by `url` OR `listing_id`: brand, model, reference number… #
POST /copart/v1/lot_detail Full detail for one lot by `lot_number`: VIN (publicly masked by Copart), make… #
POST /copart/v1/lot_images All auction photos for one lot by `lot_number`: ordered full-size, hi-res and… #
POST /copart/v1/yards Live list of Copart yards / locations you can filter `search` by, each with its… #
POST /ebay/v1/item_detail Full eBay item detail by item_id or listing URL: title, price, list price… #
POST /ebay/v1/items_batch Look up MANY eBay listings in ONE call by item number — up to 15 per request →… #
POST /ebay/v1/seller_items All active listings in a seller's storefront by `seller` username (eBay _ssn)… #
POST /ebay/v1/seller_profile Seller reputation by `seller` username -> seller_profile{store_name… #
POST /ebay/v1/deals eBay Daily Deals grid (/deals) -> results[]{item_id,title,price{value,currency}… #
POST /ebay/v1/categories eBay category tree / ID lookup (/n/all-categories) ->… #
POST /encar/v1/detail Full detail for one car by `id`: price (만원 + KRW), make/model/grade (Korean +… #
POST /encar/v1/makes Browse all Korean (domestic) and imported makes available on Encar, each with… #
POST /enrich-recall/v1/product_match Resolve a product (GTIN ‖ title+brand ‖ listing_url) and match it against FDA +… #
POST /enrich-recall/v1/brand_check All recalls for a brand / recalling-firm (normalized passthrough of the recall… #
POST /enrich-recall/v1/batch Scan up to 25 catalog products in one call (seller pre-listing audit). #
POST /enrich-store/v1/store_lookup store domain → platform verdict + store metadata + tech-stack + catalog sample… #
POST /enrich-store/v1/platform_detect store domain → ecommerce platform verdict… #
POST /enrich-store/v1/batch look up to 5 stores in one call (basic mode, cache-first, per-store ok/error) #
POST /etsy/v1/listings/detail Full Etsy listing detail by listing ID or URL — title, price, sale price… #
POST /etsy/v1/shops/detail Etsy shop profile by shop slug or URL — name, total lifetime sales, location… #
POST /etsy/v1/shops/listings Browse a shop's full active catalog, paginated — every product the shop sells… #
POST /etsy/v1/listings/category Browse Etsy by category (the /c/ grid) — discover trending/popular listings in… #
POST /etsy/v1/reviews/shop Customer reviews for an Etsy shop — star rating, review text, reviewer, date… #
POST /etsy/v1/reviews/listing Customer reviews for a single Etsy listing — star rating, review text… #
POST /etsy/v1/search/suggest Etsy search autocomplete — keyword suggestions for a partial query (no account… #
POST /flipkart/v1/product full product page facts (title/price/mrp/rating/specs/highlights/images/seller/s… #
POST /flipkart/v1/reviews Flipkart buyer reviews for a product, paginated — each review has rating… #
POST /flipkart/v1/category category/browse listing cards from a Flipkart category URL/path #
POST /flipkart/v1/browse Alias of the `category` action — browse/listing cards from a Flipkart category… #
POST /flipkart/v1/similar similar/related products from a product page reco widgets #
POST /flipkart/v1/seller Who sells a product: seller id, fulfilment and availability, resolved from a… #
POST /flipkart/v1/autocomplete search autosuggest suggestions for a partial query #
POST /flipkart/v1/categories top-level navigation/category links from homepage state #
POST /flipkart/v1/variants Product variants (the sibling SKUs — color/storage/size) each with its OWN… #
POST /flipkart/v1/filters Available search filters (facets) for a query — every filter Flipkart offers… #
POST /flipkart/v1/offers Bank, EMI, exchange and cashback offers for a product (the offer strip on the… #
POST /goat/v1/suggest Autocomplete suggestions for a partial query — quick product + collection name… #
POST /goat/v1/product_detail Full catalogue record for one product by `slug` / `url` / `product_id`: name… #
POST /goat/v1/prices Live per-size resale price grid for a product (the market-data moat). #
POST /grailed/v1/listing_detail Full detail for one listing by `id` or `url`: title, description, price, size… #
POST /grailed/v1/sold_listings Search SOLD listings (resale comps) by keyword + the same filters as search. #
POST /grailed/v1/seller_listings All active listings from one seller's storefront by `seller_id`. #
POST /grailed/v1/designers Search Grailed's designer/brand directory by name → id, slug, listings_count… #
POST /grailed/v1/designer_detail Designer/brand profile by `slug`: id, title, description, follower count and… #
POST /gumtree/v1/listing_detail Full advert detail by listing `url` OR numeric `id`: title, full description… #
POST /gumtree/v1/similar Related / similar adverts for a given listing (by `url` or `id`) — Gumtree's… #
POST /gumtree/v1/categories Gumtree's full browse tree — the top-level categories (Motors, For Sale… #
POST /gumtree/v1/filters Available filters & facets for a category and/or location: selectable… #
POST /gumtree/v1/suggestions Keyword suggestions & spelling corrections for a search term — Gumtree's 'did… #
POST /hepsiburada/v1/product/detail Full Hepsiburada product details by `url` or HB code (`sku`): title, brand… #
POST /hepsiburada/v1/product/reviews Paginated customer reviews for a product by `sku` or `url`. #
POST /hepsiburada/v1/product/offers Every merchant listing (buybox + other sellers) for a product by `sku` or… #
POST /hepsiburada/v1/category Browse a Hepsiburada category page by its path (`category` = '-c-', e.g. #
POST /hepsiburada/v1/seller Hepsiburada merchant (mağaza) profile + its product catalogue by store slug… #
POST /hs-code/v1/hs_lookup One HS/HTS/commodity code + destination (US|UK) → the official tariff line… #
POST /hs-code/v1/classify Product description (+materials) + destination → ranked candidate HS codes with… #
POST /hs-code/v1/landed_cost HS code (or description → auto-classified) + destination + value (+origin… #
POST /hs-code/v1/schedules_status Freshness + coverage of the underlying official schedules (US HTS revision, UK… #
POST /hs-code/v1/batch_classify Up to 25 products in one call (discounted). #
POST /hs-code/v1/browse Navigate the tariff tree without knowing a keyword: list the 21 WCO sections… #
POST /hs-code/v1/validate Check whether a code is a real, current tariff code in the chosen market… #
POST /hs-code/v1/cross_country One 6-digit HS subheading (the WCO-international level shared by every member… #
POST /made-in-china/v1/categories The 27 top-level sourcing categories of the buying-request board, with the ids… #
POST /magiceden/v1/collections Browse Magic Eden collections (paginated). #
POST /magiceden/v1/collection Full collection detail by symbol: metadata (name, description, image… #
POST /magiceden/v1/stats Live market stats for a collection: floor price (SOL), number of NFTs currently… #
POST /magiceden/v1/listings Active NFT listings in a collection (NFTs currently for sale), cheapest first. #
POST /magiceden/v1/tokens All tokens (NFTs) in a collection (listed or not), paginated. #
POST /magiceden/v1/token Single NFT / token detail by its Solana mint address: name, collection, current… #
POST /magiceden/v1/token_activity On-chain activity history for a single NFT by mint address: every sale… #
POST /magiceden/v1/activity Recent on-chain activity for a collection: sales, listings, delistings and bids. #
POST /magiceden/v1/attributes Trait floor prices for a collection — for every trait value (e.g. #
POST /magiceden/v1/wallet NFTs held by a Solana wallet address: each token's mint, name, collection… #
POST /magiceden/v1/launchpad Magic Eden Launchpad collections — upcoming and live primary mints. #
POST /mercadolibre/v1/deals MercadoLibre's live deals feed (Ofertas del día) — discounted listing cards… #
POST /mercadolibre/v1/category_items Products listed in a MercadoLibre category — title, price… #
POST /mercadolibre/v1/reviews Buyer reviews for a catalog product — full review text, rating and date… #
POST /mercadolibre/v1/suggest Search-term autocomplete — what MercadoLibre suggests as a shopper types #
POST /mercadolibre/v1/category Browse the MercadoLibre category tree — a category's name, total item count… #
POST /newegg/v1/price Live price and stock for ONE item — the cheap way to refresh products you… #
POST /newegg/v1/product Full product detail by item_id or url — price, list price, promotion, brand… #
POST /newegg/v1/reviews Customer reviews for a Newegg product — fully paginated through ALL reviews… #
POST /newegg/v1/best_sellers Top best-selling products for a keyword or category (Newegg's Best Selling… #
POST /newegg/v1/qna product Q&A questions and answers from PDP initial state #
POST /newegg/v1/category Browse a Newegg subcategory's product listing by subcategory_id, paginated. #
POST /newegg/v1/browse Alias of the category action — browse a subcategory's product listing, paginated #
POST /newegg/v1/deals Shell Shocker daily deal items #
POST /newegg/v1/categories top-level store/category nodes from homepage RolloverMenu #
POST /newegg/v1/filters search facets, department navigation, and sort options for a query #
POST /newegg/v1/similar related product cards from a product detail page #
POST /newegg/v1/category_tree nested category navigation tree from a Newegg store landing page #
POST /newegg/v1/variants Product family/variant options from the PDP — size/capacity/colour family… #
POST /opensea/v1/collection Full collection detail by slug: floor price, top offer, 24h + total volume… #
POST /opensea/v1/items Paginated items (NFTs) in a collection. #
POST /opensea/v1/item Single NFT / item detail by collection contract + token id: name, image, all… #
POST /opensea/v1/activity Recent on-chain activity for a collection (default: sales). #
POST /opensea/v1/holders Top holders (owners) of a collection, ranked by quantity owned. #
POST /otto/v1/browse Browse an Otto.de category landing (e.g. #
POST /otto/v1/product Product facts for one Otto.de item by variation id — name, brand, price (EUR)… #
POST /otto/v1/deals Current Otto.de deal / sale campaign products (e.g. #
POST /otto/v1/new_arrivals Newest products on Otto.de — keyword or category sorted newest-first… #
POST /otto/v1/brands Brand filter links available on an Otto.de category landing page — feed the… #
POST /otto/v1/categories Otto.de department tree — top-level departments from the homepage, or the child… #
POST /otto/v1/filters Discover the sort orders and filter query params supported by Otto.de… #
POST /otto/v1/reviews Aggregate customer rating for an Otto.de item — average star rating and total… #
POST /rakuten/v1/item Get a Rakuten Ichiba product's detail — title, price (JPY), brand, shop… #
POST /rakuten/v1/reviews Get ALL buyer reviews for a Rakuten Ichiba item, paginated (30/page) — rating… #
POST /rakuten/v1/variants Get a Rakuten Ichiba item's SKU variant matrix — every color/size/option… #
POST /rakuten/v1/shop List a Rakuten Ichiba shop's catalog by shop_code — every item the shop sells… #
POST /rakuten/v1/ranking Get the Rakuten Ichiba best-seller ranking — overall or for a genre, by… #
POST /rakuten/v1/genres Browse the Rakuten Ichiba category (genre) tree — top-level categories, or pass… #
POST /shopee/v1/product Full Shopee product detail by shop id + item id, or by product link. #
POST /shopee/v1/batch Up to 20 Shopee products in ONE call, fetched in parallel — the same data as… #
POST /shopee/v1/shop Seller profile for a Shopee shop by shop id or shop handle — name, description… #
POST /shopee/v1/shop_showcase The one product Shopee itself publishes for a shop — WITH a real, live price… #
POST /shopify/v1/products Paginated product catalog from any public Shopify store: title, vendor… #
POST /shopify/v1/product Full detail for a single Shopify product by its handle (URL slug) or product… #
POST /shopify/v1/collections Paginated list of public collections from a Shopify store: collection id… #
POST /shopify/v1/collection_products Paginated products within a specific Shopify collection — same product shape as… #
POST /shopify/v1/recommendations Related or complementary products that a Shopify store recommends for a given… #
POST /shopify/v1/collection Metadata for a single Shopify collection by handle: title, description, cover… #
POST /shopify/v1/pages Content pages published on a Shopify store (About, FAQ, Shipping, size guides… #
POST /shopify/v1/store_info Rich profile for a Shopify store: name, currency, country/city, product &… #
POST /stockx/v1/product_detail full product by `url` OR `url_key`/`id`/`uuid`… #
POST /stockx/v1/recent_sales recent transaction feed by `url`/`url_key`/`id` → sales[]{amount,created_at}… #
POST /stockx/v1/suggest autocomplete query suggestions for `query` (QuerySuggestion text; falls back to… #
POST /stockx/v1/price_history historical price time-series for a product, aggregated from the deep sales feed… #
POST /stockx/v1/sales_history deep paginated transaction log → sales[]{amount,created_at,cursor} (newest… #
POST /stockx/v1/browse category/vertical grids + sort + facet filters →… #
POST /tiktok-shop/v1/product_detail Full TikTok Shop product record in ONE call, for any of the ten markets… #
POST /tiktok-shop/v1/products_by_ids Look up as many as 15 US products in a SINGLE call — the cheapest way to… #
POST /tiktok-shop/v1/category_tree TikTok Shop's own category taxonomy for any of the ten markets — 28 top-level… #
POST /tiktok-shop/v1/category_products Browse a whole category and page through it — around 100 products per category… #
POST /tiktok-shop/v1/seller_profile A TikTok Shop seller's full public profile on any of the ten markets — shop… #
POST /tiktok-shop/v1/seller_catalog Every product a seller has listed, paged to the end — verified complete against… #
POST /tiktok-shop/v1/ranking_list TikTok Shop's own best-seller board for the US — the 20 products TikTok is… #
POST /tiktok-shop/v1/premium_offers TikTok Shop's US 'premium offers' deal board, paged to the end — around 97… #
POST /tiktok-shop/v1/reviews Customer reviews for a product on any of the ten markets — three full review… #
POST /tokopedia/v1/detail Full product detail by product url: price, slashed/original price, discount… #
POST /tokopedia/v1/shop Store/shop profile by shop domain (the tokopedia.com/ handle): name… #
POST /tokopedia/v1/shop_products Paginated product catalog of one shop by shop domain. #
POST /tokopedia/v1/reviews Paginated public product reviews by product_id (or url): star rating, review… #
POST /trendyol/v1/product/detail full product by `url` OR `content_id`: title/brand/price(current+list+discount%/… #
POST /trendyol/v1/product/reviews paginated reviews by `content_id` OR `url`: {ai_summary (AI review digest)… #
POST /trendyol/v1/product/similar similar/cross-sell products by `content_id` OR `url` →… #
POST /trendyol/v1/search/filters Discover the available filter facets for a `query` OR `category_id` before… #
POST /trendyol/v1/category/products Browse a Trendyol category by id — best-sellers, newest, or… #
POST /trendyol/v1/seller/products All products of a Trendyol seller/store (paginated, sortable, filterable) by… #
POST /trendyol/v1/seller/info Trendyol seller/store profile by seller_id: store name, legal entity… #
POST /trendyol/v1/suggest keyword suggestions for a query (ops; search-fallback if suggest API blocked) #
POST /vinted/v1/item_detail Full Vinted item detail — title, price, photos, description, size, color… #
POST /vinted/v1/seller seller profile (login/rating/item_count/feedback breakdown) — PII redactable #
POST /vinted/v1/seller_items a seller's wardrobe items #
POST /vinted/v1/seller_feedback feedback left for a seller (text/rating/reviewer) #
POST /vinted/v1/autocomplete search typeahead — partial query -> ranked Vinted search suggestions (localized… #
POST /vinted/v1/similar items similar to a given item (items/{id}/more) #
POST /vinted/v1/catalog_filters dynamic facets (size/brand/status/color/price/material + option ids) for a… #
POST /vinted/v1/categories Full Vinted category tree — id, title, code, URL and child categories for the… #
POST /vinted/v1/colors color enum (id/title/hex/code) #
POST /vinted/v1/conditions item-condition enum (status id/title) #
POST /vinted/v1/countries country enum (id/iso/currency) #
POST /vinted/v1/sizes size groups + size ids #
POST /walmart/v1/product_detail Full product record by Walmart item id (or product URL): name, brand, model… #

Documentation

📖
Documentation
https://reefapi.com/docs
📖
APIReference
https://reefapi.com/apis
📖
Quickstart
https://reefapi.com/docs#quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-e-commerce-marketplaces-api-openapi.yml

Other Resources

🔗
DeveloperPortal
https://reefapi.com/docs
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/data-model/reefapi-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/errors/reefapi-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/conventions/reefapi-conventions.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/reefapi-e-commerce-marketplaces-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

reefapi-e-commerce-marketplaces-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Reef E-commerce & Marketplaces API
  version: 1.0.0
  description: Unified data-API gateway. Call POST /{engine}/v1/{action} with an x-api-key header; every response is the { ok, data, meta, error } envelope.
servers:
- url: https://api.reefapi.com
security:
- ApiKeyAuth: []
tags:
- name: E-commerce & Marketplaces
paths:
  /aliexpress/v1/search:
    post:
      operationId: aliexpress_search
      summary: Product search cards (price, sold_count, rating, store); filters…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                country:
                  type: string
                currency:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_results:
                  type: string
                sort:
                  type: string
                min_price:
                  type: string
                max_price:
                  type: string
                ship_from:
                  type: string
                free_shipping:
                  type: string
            example:
              query: wireless earbuds
              country: US
              currency: USD
      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
  /aliexpress/v1/product_detail:
    post:
      operationId: aliexpress_product_detail
      summary: Full product + SKU-variant price/stock matrix + specs + images + video + store…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                url:
                  type: string
                country:
                  type: string
                currency:
                  type: string
                language:
                  type: string
                province:
                  type: string
                city:
                  type: string
            example:
              product_id: '3256808363596774'
      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
  /aliexpress/v1/reviews:
    post:
      operationId: aliexpress_reviews
      summary: Buyer reviews (paginated — fetch many pages in one call) + rating distribution
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                url:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_results:
                  type: string
                page_size:
                  type: string
                filter:
                  type: string
                review_sort:
                  type: string
                country:
                  type: string
                currency:
                  type: string
            example:
              product_id: '3256808363596774'
              page_size: 10
      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
  /aliexpress/v1/similar:
    post:
      operationId: aliexpress_similar
      summary: Products similar to a given item (search-backed 'more like this', seed product…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                url:
                  type: string
                query:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_results:
                  type: string
                sort:
                  type: string
                country:
                  type: string
                currency:
                  type: string
      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
  /aliexpress/v1/description:
    post:
      operationId: aliexpress_description
      summary: Full product description text + images
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                url:
                  type: string
                description_url:
                  type: string
                country:
                  type: string
                currency:
                  type: string
      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
  /aliexpress/v1/shipping:
    post:
      operationId: aliexpress_shipping
      summary: Shipping options per destination country
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                product_id:
                  type: string
                url:
                  type: string
                country:
                  type: string
                currency:
                  type: string
                language:
                  type: string
                province:
                  type: string
                city:
                  type: string
      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
  /aliexpress/v1/store_info:
    post:
      operationId: aliexpress_store_info
      summary: Store profile (+ live seller metrics when a query is supplied)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                store_id:
                  type: string
                store_url:
                  type: string
                query:
                  type: string
                country:
                  type: string
                currency:
                  type: string
            example:
              store_id: '1103576287'
      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
  /aliexpress/v1/deals:
    post:
      operationId: aliexpress_deals
      summary: SuperDeals / discounted cards (search-derived, sorted by discount)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                min_discount:
                  type: string
                sort:
                  type: string
                page:
                  type: string
                max_pages:
                  type: string
                max_results:
                  type: string
                country:
                  type: string
                currency:
                  type: string
              required:
              - query
            example:
              query: wireless earbuds
      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
  /allegro/v1/search:
    post:
      operationId: allegro_search
      summary: Search Allegro by keyword — returns offer cards with title, price (PLN)…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                max_pages:
                  type: string
                sort:
                  type: string
                min_price:
                  type: string
                max_price:
                  type: string
                condition:
                  type: string
                free_delivery:
                  type: string
                category:
                  type: string
              required:
              - query
            example:
              query: iphone 15
      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
  /allegro/v1/category:
    post:
      operationId: allegro_category
      summary: Browse an Allegro category without a keyword (the /kategoria/ grid) — discover…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  type: string
                max_pages:
                  type: string
                sort:
                  type: string
                min_price:
                  type: string
                max_price:
                  type: string
                condition:
                  type: string
                free_delivery:
                  type: string
              required:
              - category
      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
  /allegro/v1/offer:
    post:
      operationId: allegro_offer
      summary: Single Allegro offer/product detail by id or URL — title, price (PLN), main…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                offer_id:
                  type: string
                offer_url:
                  type: string
                url:
                  type: string
            example:
              offer_id: '18673156866'
      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
  /allegro/v1/seller_offers:
    post:
      operationId: allegro_seller_offers
      summary: A seller's public active listings, paginated — every offer a seller (shop) has…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                seller:
                  type: string
                max_pages:
                  type: string
                sort:
                  type: string
              required:
              - seller
      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
  /allegro/v1/suggested:
    post:
      operationId: allegro_suggested
      summary: Related/recommended Allegro offers for a keyword — a quick set of relevant…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
              required:
              - query
            example:
              query: iphone 15
      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
  /amazon/v1/product/detail:
    post:
      operationId: amazon_product_detail
      summary: full product page (title/price/currency/rating/count/brand/features/images/categ…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asin:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/product/reviews:
    post:
      operationId: amazon_product_reviews
      summary: Amazon product reviews by ASIN — the public reviews from the product page (and…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asin:
                  type: string
                marketplace:
                  type: string
                marketplaces:
                  type: string
              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
  /amazon/v1/product/offers:
    post:
      operationId: amazon_product_offers
      summary: pinned buybox + all-offers (AOD aodAjaxMain)…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asin:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/search:
    post:
      operationId: amazon_search
      summary: product search with optional filters (price range, minimum rating, deals…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                marketplace:
                  type: string
                page:
                  type: string
                max_results:
                  type: string
                sort:
                  type: string
                price_min:
                  type: string
                price_max:
                  type: string
                min_rating:
                  type: string
                deals:
                  type: string
                discount:
                  type: string
                prime:
                  type: string
                brand:
                  type: string
              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
  /amazon/v1/products_batch:
    post:
      operationId: amazon_products_batch
      summary: Look up MANY Amazon products in ONE call by ASIN — up to 15 per request → each…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asins:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/bestsellers:
    post:
      operationId: amazon_bestsellers
      summary: best-sellers ranking for a department (category slug required)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  type: string
                marketplace:
                  type: string
                max_results:
                  type: string
              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
  /amazon/v1/new-releases:
    post:
      operationId: amazon_new_releases
      summary: new-releases ranking for a department (category slug required)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category:
                  type: string
                marketplace:
                  type: string
                max_results:
                  type: string
              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
  /amazon/v1/seller/profile:
    post:
      operationId: amazon_seller_profile
      summary: seller profile (name, feedback %, lifetime ratings, rating)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                seller_id:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/autocomplete:
    post:
      operationId: amazon_autocomplete
      summary: search autocomplete suggestions
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/seller/products:
    post:
      operationId: amazon_seller_products
      summary: a seller's catalog/storefront by seller_id (paginated)
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                seller_id:
                  type: string
                marketplace:
                  type: string
                page:
                  type: string
              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
  /amazon/v1/seller/reviews:
    post:
      operationId: amazon_seller_reviews
      summary: seller FEEDBACK reviews (rating/text/rater/date) by seller_id
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                seller_id:
                  type: string
                marketplace:
                  type: string
              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
  /amazon/v1/deals:
    post:
      operationId: amazon_deals
      summary: 'Amazon deal-products (today''s deals / goldbox): asin/title/price/image'
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                marketplace:
                  type: string
      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
  /amazon/v1/product/related:
    post:
      operationId: amazon_product_related
      summary: Amazon related & recommended products by ASIN — the product-recommendation…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                asin:
                  type: string
                marketplace:
                  type: string
              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
  /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…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                gtin:
                  type: string
                marketplace:
                  type: string
            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
  /asos/v1/search:
    post:
      operationId: asos_search
      summary: Keyword product search across the ASOS catalogue with filters (price, brand…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                store:
                  type: string
                lang:
                  type: string
                currency:
                  type: string
                country:
                  type: string
                offset:
                  type: string
                limit:
                  type: string
                sort:
                  type: string
                min_price:
                  type: string
                max_price:
                  type: string
                brand:
                  type: string
                colour:
                  type: string
                color:
                  type: string
                size:
                  type: string
                product_type:
                  type: string
                on_sale:
                  type: string
                new_in_within:
                  type: string
                discount:
                  type: string
                channel:
                  type: string
                key_store_dataversion:
                  type: string
              required:
              - query
            example:
              query: dress
      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
  /asos/v1/category:
    post:
      operationId: asos_category
      summary: Browse all products in a category by category_id, with the same filters…
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                category_id:
                  type: string
                store:
                  type: string
                lang:
                  type: string
                currency:
                  type: string
                country:
                  type: string
                offset:
                  type: string
                limit:
                  type: string
                sort:
                  type: string
                min_price:
                  type: string
                max_price:
                  type: string
                brand:
                  type: string
                colour:
                  type: string
                color:
                  type: string
                size:
                  type: string
                product_type:
                  type: string
                on_sale:
                  type: string
                new_in_within:
                  type: string
                discount:
                  type: string
                channel:
                  type: string
              required:
              - category_id
            example:
              category_id: '8799'
      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
  /asos/v1/sale:
    post:
      operationId: asos_sale
      summary: On-sale / marked-down products only.
      tags:
      - E-commerce & Marketplaces
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                category_id:
                  type: string
                store:
                  type: 

# --- truncated at 32 KB (263 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/reefapi/refs/heads/main/openapi/reefapi-e-commerce-marketplaces-api-openapi.yml