Alibaba.com B2B Wholesale API & Scraper
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….
🤖 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 track product listings, prices, availability, variants and reviews 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.
Alibaba fields that matter to a buyer: ladder, MOQ, supplier
Alibaba is a wholesale board, so a listing has no single price and no single quantity. The card price is a span, the real price is a ladder you only get from product_detail, and the minimum order quantity is a number plus a unit the supplier typed by hand. Every value below was measured on 2026-08-27 against listing 1601271583307 and one 48-row search page for 'led strip'.
| Field | What it holds | Measured value |
|---|---|---|
| product_id | Alibaba's own id, a digit string (13 digits today), identical in search and product_detail | "1601271583307" |
| price_ladder[] | The quantity tiers, cheapest last. max_quantity is null on the open-ended top tier | 5-2999 at $0.76, 3000-4999 at $0.74, 5000-9999 at $0.72, 10000+ at $0.69 |
| price.min / price.max (search) | The cheapest and dearest tier of that ladder, as shown on the card | 0.69 and 0.76 for the listing above, matching both ends of its ladder |
| moq.quantity + moq.unit | The number and the unit it is counted in. Not normalized, singular and plural both occur | 5 and "meters". One 48-row page held meters, meter, pieces, piece, sets, bags |
| supplier.company_id | Alibaba's numeric company id, returned as a string | "239980482", Shenzhen Ledodm Lighting Co., Ltd., country CN |
| supplier.verified | The on-site Verified Supplier programme. A real boolean, never null | true on 32 of the 48 rows of the default 'led strip' page |
| variants[].sku_id | Per-variant id from the attribute matrix. Its own price field is null on every variant | "105939040337", stock 9999999, in_stock true |
| supplier_country | ISO-2 code of the supplier, applied server-side | IN returned 48 of 48 IN rows, TR returned 48 of 48 TR rows |
| is_ad | Paid placement in the search grid | true on 23 of the 48 rows for 'led strip' |
| rfq_id | Id of a buying request on the sourcing board, a digit string | "1684578939", posted 14 minutes before the call |
search returns 48 offers per page alongside total_estimate; rfq_search returns 20 per page. An unrecognized supplier_country does not come back empty: three probes with 'XX' all failed with TARGET_BLOCKED while 'IN' and 'TR' answered immediately, so pass codes you have actually seen in supplier.country. On the RFQ board Alibaba spells the United Kingdom 'UK', not 'GB'.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/alibaba/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "led strip"
}
}{
"ok": true,
"meta": {
"api": "alibaba",
"endpoint": "search",
"mode": "live",
"latency_ms": 6234.4,
"record_count": 48,
"bytes": 959716,
"cache_hit": false,
"query": "led strip",
"page": 1,
"charged_credits": 1,
"version": "1.0.0"
},
"data": {
"results": [
{
"product_id": "11000014531826",
"title": "Custom 2835 5050 5M 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-2835-5050-5M-10M-15M_11000014531826.html",
"image": "https://s.alicdn.com/@sc04/kf/Ab02ad7934441494dbaa1561f9d15cb16D.jpg_300x300.jpg",
"images": [
"https://s.alicdn.com/@sc04/kf/Ab02ad7934441494dbaa1561f9d15cb16D.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": "$1.03-2.22",
"currency": "USD",
"min": 1.03,
"max": 2.22
},
"promotion_price": null,
"currency": "USD",
"moq": {
"text": "Min. order: 10 meters",
"quantity": 10,
"unit": "meters"
},
"sold_count": 2581,
"rating": 4.9,
"review_count": 15,
"supplier_service_score": 5,
"shipping_score": 4.9,
"supplier": {
"company_id": "281188253",
"name": "Fuzhou Twinklight Imp.&exp. Co., Ltd.",
"country": "CN",
"years_on_alibaba": "4 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": "1601608597299",
"title": "Factory Wholesale 5V 12V 24V 220V COB White RGBIC 3mm 5mm 8mm 10mm 12mm Rgb RGBW CCT CE RoHs Led Strip Light Lights Decoration",
"url": "https://www.alibaba.com/product-detail/Factory-Wholesale-5V-12V-24V-220V_1601608597299.html",
"image": "https://s.alicdn.com/@sc04/kf/H4fd054f001254aa4963772e4dead2477m.jpg_300x300.jpg",
"images": [
"https://s.alicdn.com/@sc04/kf/H4fd054f001254aa4963772e4dead2477m.jpg_300x300.jpg",
"https://s.alicdn.com/@sc04/kf/H980eeb0b77c140009fceb859d46485cdc.jpg_300x300.jpg",
"https://s.alicdn.com/@sc04/kf/Ha449a03b008b4b738d11e92a755364a5B.jpg_300x300.jpg"
],
"price": {
"text": "$0.6398-1.48",
"currency": "USD",
"min": 0.6398,
"max": 1.48
},
"promotion_price": null,
"currency": "USD",
"moq": {
"text": "Min. order: 5 meters",
"quantity": 5,
"unit": "meters"
},
"sold_count": 5746,
"rating": 5,
"review_count": 18,
"supplier_service_score": 4.9,
"shipping_score": 4.7,
"supplier": {
"company_id": "240915394",
"name": "Shenzhen Ledbuilders Optoelectronic Technology Co., Ltd.",
"country": "CN",
"years_on_alibaba": "9 yrs",
"verified": true,
"logo": "https://sc02.alicdn.com/kf/HTB1ssMDav5TBuNjSspm761DRVXaS.png",
"url": "https://ledbuilders.en.alibaba.com/",
"profile_url": "https://ledbuilders.en.alibaba.com/company_profile.html"
},
"certifications": [
"Declaration of Conformity",
"UKCA",
"RoHS"
],
"is_ad": false
},
{
"product_id": "1601381710279",
"title": "30MM Rgbw Eave Led Pixel Point Lights 12V 24V 36V IP68 Warm White Gemstone Permanent Outdoor Christmas Lighting",
"url": "https://www.alibaba.com/product-detail/30MM-Rgbw-Eave-Led-Pixel-Point_1601381710279.html",
"image": "https://s.alicdn.com/@sc04/kf/Hc5485308396047d6a7de0ceaabf30b44D.png_300x300.png",
"images": [
"https://s.alicdn.com/@sc04/kf/Hc5485308396047d6a7de0ceaabf30b44D.png_300x300.png",
"https://s.alicdn.com/@sc04/kf/H208b06199a2442238327313a69404eb8r.jpg_300x300.jpg",
"https://s.alicdn.com/@sc04/kf/H839bc9fcc7f74693821dffdd945a7842t.jpg_300x300.jpg"
],
"price": {
"text": "$1.26",
"currency": "USD",
"min": 1.26,
"max": 1.26
},
"promotion_price": null,
"currency": "USD",
"moq": {
"text": "Min. order: 2 pieces",
"quantity": 2,
"unit": "pieces"
},
"sold_count": 95657,
"rating": 4.9,
"review_count": 27,
"supplier_service_score": 4.7,
"shipping_score": 4.6,
"supplier": {
"company_id": "242137331",
"name": "GJQpermanent light Co., Ltd.",
"country": "CN",
"years_on_alibaba": "8 yrs",
"verified": true,
"logo": "https://sc02.alicdn.com/kf/H221743fc6e0f4b75acf3c8ab4d0f8ce7x.jpg",
"url": "https://szgjqkj.en.alibaba.com/",
"profile_url": "https://szgjqkj.en.alibaba.com/company_profile.html"
},
"certifications": [
"CE",
"RoHS"
],
"is_ad": true
}
],
"query": "led strip",
"page": 1,
"page_size": 48,
"total_estimate": 2179,
"has_more": true,
"next_page": 2
}
}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 | Pricing 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 | Marketplace operators 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 | Catalog enrichment teams call rfq_search to search live buying requests (RFQs) posted by Alibaba buyers. | query, page, sort, buyer_country, category_id, ... |
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();Ask your MCP-connected assistant: call reefapi.alibaba.search with {"query":"led strip"}.Who uses this API and why
- Pricing teams use Alibaba.com B2B Wholesale to search alibaba.com wholesale listings by keyword.
- Marketplace operators use Alibaba.com B2B Wholesale to get full wholesale detail for one alibaba.com listing.
- Catalog enrichment teams use Alibaba.com B2B Wholesale to search live buying requests (RFQs) posted by Alibaba buyers.
Questions developers ask before integrating
Where do I get Alibaba's tiered wholesale prices?
From product_detail, in price_ladder. A search row only carries the span. Listing 1601271583307 came back from search as "$0.69-0.76" and from product_detail as four tiers: 5 to 2999 units at $0.76, 3000 to 4999 at $0.74, 5000 to 9999 at $0.72 and 10000-and-above at $0.69. The last tier's max_quantity is null because it is open-ended, and every tier also carries price_usd so tiers stay comparable when the page is priced in another currency.
What do price.min and price.max mean on an Alibaba search row?
They are the two ends of that listing's ladder: the cheapest tier and the dearest tier. When they are equal the listing is flat-priced. Measured against the ladder above, the search row reported min 0.69 and max 0.76 and the ladder's own ends were 0.69 and 0.76. On listings the supplier publishes as 'contact for price', price comes back null rather than as a fabricated number.
Is the Alibaba minimum order quantity normalized?
No. moq.quantity is a number and moq.unit is whatever the supplier typed, so you cannot compare across listings without deciding what a unit means. One 48-row page for 'led strip' contained meters, meter, pieces, piece, sets and bags, and a page of Indian suppliers added kilogram alongside kilograms. The min_order and max_order filters compare the number only, never the unit.
Why is variants[].price null and variants[].stock 9999999?
On Alibaba the price lives in the quantity ladder, not on the SKU, so variant rows carry the attribute combination and its id rather than a price of their own. The stock number is the supplier's unlimited placeholder: every variant of 1601271583307 reported 9999999. Read in_stock as the boolean and treat a figure that size as 'not a real count'.
Does a search row tell me whether a listing has Trade Assurance?
No. trade_assurance exists as a search filter, so you can restrict a query to covered listings, but the returned rows carry no such flag. The credential fields that do come back per row are supplier.verified, supplier.years_on_alibaba, certifications[] and three scores: rating, supplier_service_score and shipping_score. product_detail adds the supplier scorecard, with response_time, on_time_delivery_rate and reorder_rate.
What is rfq_search and how fresh are the requests?
It reads Alibaba's sourcing board, which is the demand side: purchases buyers are asking for right now, in their own words. With sort='recent' the top of page one was 14 minutes old when measured. posted_hours_ago and posted_at_estimate are both derived from the relative label Alibaba prints ('14 minutes before'), so treat them as minute-resolution estimates rather than a timestamp published by the source.
Which RFQ fields come back empty?
On a 20-row page filtered to buyer_country='US', budget, budget_currency, expires_at, rfq_level and buyer.level were null on every row, because the listing board does not publish them. What is populated is title, description, quantity with quantity_unit, buyer name and country, rfq_star_level and has_attachments. Alibaba also truncates the buyer's own text at roughly 210 characters, and description_truncated was true on 15 of those 20 rows.
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 an 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. 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 an 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.