Other

Alibaba.com B2B Wholesale API

Alibaba.com B2B Wholesale API returns live Alibaba.com B2B Wholesale data as clean JSON for alibaba.com b2b wholesale The primary endpoint, search, returns results[] — one supplier offer per row: product_id (Alibaba's own numeric id as a string; pass it straight to product_detail), title, url….

3 actionsLive JSON1,000 free creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to validate, enrich, classify and normalize operational data without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Alibaba.com B2B Wholesale scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, product_detail, rfq_search. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Aug 5, 2026, 11:05 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/alibaba/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "led strip"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "alibaba",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 8070.8,
    "record_count": 48,
    "bytes": 1110328,
    "cache_hit": false,
    "method": "web_html_json_island",
    "query": "led strip",
    "page": 1
  },
  "data": {
    "results": [
      {
        "product_id": "[redacted-phone]",
        "title": "Custom [redacted-phone]M 10M 15M 20M 30M Wheel Decorative Light RGB RGBW 24V 12V 5V Waterproof Neon Outdoor Smart Led Strip Light",
        "url": "https://www.alibaba.com/product-detail/Custom-[redacted-phone]M-10M-15M_[redacted-phone].html",
        "image": "https://s.alicdn.com/@sc04/kf/Ab02ad[redacted-phone]dbaa1561f9d15cb16D.jpg_300x300.jpg",
        "images": [
          "https://s.alicdn.com/@sc04/kf/Ab02ad[redacted-phone]dbaa1561f9d15cb16D.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/A9efa31513d754614a7e7466642d2fd9dt.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/A75ef519f88e044a1904edd203d8d1705q.jpg_300x300.jpg"
        ],
        "price": {
          "text": "$[redacted-phone]",
          "currency": "USD",
          "min": 0.72,
          "max": 1.56
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 10 meters",
          "quantity": 10,
          "unit": "meters"
        },
        "sold_count": 3023,
        "rating": 4.9,
        "review_count": 15,
        "supplier_service_score": 5,
        "shipping_score": 4.9,
        "supplier": {
          "company_id": "[redacted-phone]",
          "name": "[redacted-name]",
          "country": "CN",
          "years_on_alibaba": "3 yrs",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/H6c5041c220e34a4996182e3f367cb976g.jpg",
          "url": "https://twinklight.en.alibaba.com/",
          "profile_url": "https://twinklight.en.alibaba.com/company_profile.html"
        },
        "certifications": [
          "Declaration of Conformity",
          "RoHS",
          "CE"
        ],
        "is_ad": true
      },
      {
        "product_id": "[redacted-phone]",
        "title": "2835 Smd 12V 15W/M Led Strip Light 8Mm Pcb 5M Flexible Led Strip Light for Indoor Ambient Lighting Projects",
        "url": "https://www.alibaba.com/product-detail/2835-Smd-12V-15W-M-Led_[redacted-phone].html",
        "image": "https://s.alicdn.com/@sc04/kf/H891e97bd07c84ab69f8d79e4ab056a54m.jpg_300x300.jpg",
        "images": [
          "https://s.alicdn.com/@sc04/kf/H891e97bd07c84ab69f8d79e4ab056a54m.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/H3c40dac81d7f4f[redacted-phone]dbb8259d5v.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/H16023ad31f0f480e8874f62cc936fb3a8.jpg_300x300.jpg"
        ],
        "price": {
          "text": "$1.47",
          "currency": "USD",
          "min": 1.47,
          "max": 1.47
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 100 pieces",
          "quantity": 100,
          "unit": "pieces"
        },
        "sold_count": 10,
        "rating": 5,
        "review_count": 13,
        "supplier_service_score": 4.8,
        "shipping_score": 5,
        "supplier": {
          "company_id": "[redacted-phone]",
          "name": "[redacted-name]",
          "country": "CN",
          "years_on_alibaba": "10 yrs",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/H4b4e20bedda[redacted-phone]f0e3fe26u.png",
          "url": "https://lianxinrui.en.alibaba.com/",
          "profile_url": "https://lianxinrui.en.alibaba.com/company_profile.html"
        },
        "certifications": [],
        "is_ad": false
      },
      {
        "product_id": "[redacted-phone]",
        "title": "24V Ultra Bright 400LEDs/m COB LED Strip CRI 90 Ra90 High Density Cuttable Flexible Self-Adhesive Tape for Linear Decor Lighting",
        "url": "https://www.alibaba.com/product-detail/24V-Ultra-Bright-400LEDs-m-COB_[redacted-phone].html",
        "image": "https://s.alicdn.com/@sc04/kf/H96d814911ed242f393b87599c224ff80w.jpg_300x300.jpg",
        "images": [
          "https://s.alicdn.com/@sc04/kf/H96d814911ed242f393b87599c224ff80w.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/Haaaf7da1746c41b2af51a8b67804dc16y.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/H643d127edc134205b2f02fd5e0f5ee763.jpg_300x300.jpg"
        ],
        "price": {
          "text": "$[redacted-phone]",
          "currency": "USD",
          "min": 1.28,
          "max": 2.22
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 50 meters",
          "quantity": 50,
          "unit": "meters"
        },
        "sold_count": 25,
        "rating": null,
        "review_count": 0,
        "supplier_service_score": null,
        "shipping_score": null,
        "supplier": {
          "company_id": "[redacted-phone]",
          "name": "[redacted-name]",
          "country": "CN",
          "years_on_alibaba": "1 yr",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/H4f6b91a9b53e4fd0a4fb2c42f7ca00e5c.jpg",
          "url": "https://yccled.en.alibaba.com/",
          "profile_url": "https://yccled.en.alibaba.com/company_profile.html"
        },
        "certifications": [
          "Declaration of Conformity",
          "RoHS",
          "CE"
        ],
        "is_ad": true
      }
    ],
    "query": "led strip",
    "page": 1,
    "page_size": 48,
    "total_estimate": 17970,
    "has_more": true,
    "next_page": 2
  }
}

Actions

What the Alibaba.com B2B Wholesale API does

Action	Description	Concrete use case	Key params
search	Search alibaba.com wholesale listings by keyword — 48 supplier offers per page, each with its unit price (or price range), minimum order quantity, units sold, supplier company and country, review scores and certifications. Filter by price, MOQ, supplier country, category, review score and supplier credentials; sort by relevance, sales volume, response rate or price	Ops teams call search to search alibaba.com wholesale listings by keyword.	query, page, sort, min_price, max_price, ...
product_detail	Full wholesale detail for one alibaba.com listing — the complete quantity price ladder, minimum order quantity, production lead time, gross weight and package dimensions, the full specification table, image gallery, variant matrix with native SKU ids and per-variant stock, certifications, and the supplier scorecard	Developer tools call product_detail to get full wholesale detail for one alibaba.com listing.	product_id, url
rfq_search	Search live buying requests (RFQs) posted by Alibaba buyers — the demand side of the marketplace. Each row is a purchase a real buyer is asking for right now, in their own words: what they want, how many, which country they are buying from and how long ago they posted it. Filter by keyword, buyer country, category and how recently it was posted; sort newest-first to work the board as a live feed	Validation workflows call rfq_search to search live buying requests (RFQs) posted by Alibaba buyers.	query, page, sort, buyer_country, category_id, ...

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/alibaba/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"led strip"}'

import requests

r = requests.post(
    "https://api.reefapi.com/alibaba/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "query": "led strip"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/alibaba/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "query": "led strip"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.alibaba.search with {"query":"led strip"}.

Use cases

Who uses this API and why

Ops teams use Alibaba.com B2B Wholesale to search alibaba.com wholesale listings by keyword.
Developer tools use Alibaba.com B2B Wholesale to get full wholesale detail for one alibaba.com listing.
Validation workflows use Alibaba.com B2B Wholesale to search live buying requests (RFQs) posted by Alibaba buyers.

FAQ

Questions developers ask before integrating

What is the Alibaba.com B2B Wholesale API?

Alibaba.com B2B Wholesale API is a ReefAPI endpoint group for alibaba.com b2b wholesale It returns live JSON through POST requests under /alibaba/v1.

Is the Alibaba.com B2B Wholesale API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Alibaba.com B2B Wholesale calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Alibaba.com B2B Wholesale login or account?

No login to Alibaba.com B2B Wholesale is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Alibaba.com B2B Wholesale data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Alibaba.com B2B Wholesale API use?

Alibaba.com B2B Wholesale actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Alibaba.com B2B Wholesale from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call alibaba actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Alibaba.com B2B Wholesale API a Alibaba.com B2B Wholesale scraper?

It is the managed alternative to a DIY Alibaba.com B2B Wholesale scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same alibaba.com b2b wholesale back as clean JSON.

Why does my Alibaba.com B2B Wholesale scraper keep getting blocked?

Most Alibaba.com B2B Wholesale scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / alibaba

Alibaba.com B2B Wholesale

base /alibaba/v13 endpoints

post/alibaba/v1/search1 credit

Search alibaba.com wholesale listings by keyword — 48 supplier offers per page, each with its unit price (or price range), minimum order quantity, units sold, supplier company and country, review scores and certifications. Filter by price, MOQ, supplier country, category, review score and supplier credentials; sort by relevance, sales volume, response rate or price

Parameter		Allowed / range	Description
query	required	—	What to search for on alibaba.com — a product keyword the way a buyer would type it ('led strip', 'corrugated carton box', 'nitrile gloves').
page = 1	optional	1–100	Result page, 1-based, 48 offers per page (max 100). Page forward with next_page from the response.
sort = relevance	optional	relevance · sales · response_rate	Result order. 'relevance' is Alibaba's own default mix; 'sales' ranks by units sold in the last 180 days; 'response_rate' ranks suppliers by how fast they reply. Alibaba's search has no price sort — use min_price / max_price to bound the range instead.
min_price	optional	0–	Lowest unit price to include, in the listing currency (USD from our exits).
max_price	optional	0–	Highest unit price to include, in the listing currency.
min_order	optional	0–	Only listings whose minimum order quantity is at least this. Units differ per listing (pieces, meters, sets, kilograms), so this filters the number, not a normalised quantity.
max_order	optional	1–	Only listings whose minimum order quantity is at most this — the practical filter for buyers who cannot commit to a container load.
supplier_country	optional	—	Two-letter country code of the supplier (CN, IN, VN, TR, US, DE …). Alibaba is overwhelmingly Chinese suppliers; this is how you find the others.
category_id	optional	—	Alibaba category id to restrict the search to. Category ids come back on every product_detail response, in category_id and in the categories breadcrumb.
verified_supplier	optional	—	Only suppliers Alibaba has inspected and verified on site (its 'Verified Supplier' programme).
trade_assurance	optional	—	Only listings covered by Alibaba Trade Assurance (order protection on payments made through Alibaba).
min_review_score	optional	4 · 4.5 · 5	Only suppliers at or above this review score (4, 4.5 or 5).

Try in playground →

post/alibaba/v1/product_detail1 credit

Full wholesale detail for one alibaba.com listing — the complete quantity price ladder, minimum order quantity, production lead time, gross weight and package dimensions, the full specification table, image gallery, variant matrix with native SKU ids and per-variant stock, certifications, and the supplier scorecard

Parameter		Allowed / range	Description
product_id	optional	—	Alibaba's own numeric product id — the digits before '.html' in a /product-detail/ URL, and the same value this API returns as product_id. Pass either this or url.
url	optional	—	Full alibaba.com product URL, used instead of product_id. Only alibaba.com hosts are accepted; the id is read out of the URL.

Try in playground →

post/alibaba/v1/rfq_search1 credit

Search live buying requests (RFQs) posted by Alibaba buyers — the demand side of the marketplace. Each row is a purchase a real buyer is asking for right now, in their own words: what they want, how many, which country they are buying from and how long ago they posted it. Filter by keyword, buyer country, category and how recently it was posted; sort newest-first to work the board as a live feed

Parameter		Allowed / range	Description
query	optional	—	What the buyer is asking for, in the buyer's own words — 'led strip', 'nitrile gloves', 'cnc machining'. Leave it out to browse every open request on the board (183,000+ live requests), which is what sort='recent' with a buyer_country filter is for.
page = 1	optional	1–500	Result page, 1-based, 20 requests per page (max 500). Page forward with next_page from the response.
sort = relevance	optional	relevance · recent	Result order. 'relevance' is Alibaba's own Best Match mix; 'recent' puts the newest requests first and is the one to poll — its first page is typically minutes old.
buyer_country	optional	—	Two-letter country code of the BUYER (US, IN, BR, DE, TR, AE …). Must be upper-case, and Alibaba spells the United Kingdom 'UK', not 'GB'. A code Alibaba does not recognise is rejected rather than silently ignored.
category_id	optional	—	Alibaba sourcing category id to restrict the board to (1 Agriculture, 3 Apparel & Accessories, 66 Beauty, 8 Chemicals, 2829 Commercial Equipment & Machinery …). The ids are the same ones product_detail returns.
posted_within	optional	1h · 3h · 12h · 24h · 2d · 3d · 7d · older_than_7d	Only requests posted inside this window. 'older_than_7d' is Alibaba's own inverse facet — it returns requests OLDER than a week, not newer.
with_attachments	optional	—	Only requests where the buyer attached a file — a drawing, a spec sheet or a reference photo.
open_only	optional	—	Only requests Alibaba still lists as open for quoting (its own 'Open RFQs' filter).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/alibaba/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"led strip"}'

Response shape

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