Alibaba.com B2B Wholesale API

Wholesale has no price, only a price at a quantity

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….

no credit card1,000 free credits · instant API key · pay by card or crypto
Missing a Alibaba.com B2B Wholesale endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
A
/alibaba/v1

3 active endpoints. Every call is 1 credit.

  • POST/alibaba/v1/search
  • POST/alibaba/v1/product_detail
  • POST/alibaba/v1/rfq_search

What Alibaba.com B2B Wholesale endpoints does ReefAPI ship?

3 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

3 endpoints

search

1 cr

Search alibaba.com wholesale listings by keyword.

required
query
optional
page, sort, min_price, max_price, min_order, max_order, supplier_country, category_id, verified_supplier, trade_assurance, min_review_score

product_detail

1 cr

Full wholesale detail for one alibaba.com listing.

required
optional
product_id, url

rfq_search

1 cr

Search live buying requests (RFQs) posted by Alibaba buyers.

required
optional
query, page, sort, buyer_country, category_id, posted_within, with_attachments, open_only

Every parameter, every allowed value →

Alibaba.com B2B Wholesale API

3 of 3 endpoints, ready to run

View docs ↗

Supplier offers for a keyword — unit price or price range, minimum order quantity, units sold, the supplier company and country, review scores and certifications on every row.

1 credit1 required · 3 optional
POST/alibaba/v1/search
ok3073 ms · 48 records · sample
{
  "ok": true,
  "meta": {
    "api": "alibaba",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 3072.7,
    "record_count": 48,
    "cache_hit": false
  },
  "data": {
    "results": [
      {
        "product_id": "1601761673367",
        "title": "12V Thick Gel SMD COB LED Strip 240 LEDs /m 8mm Dotless For Cabinet Showcase Shelf Linear Lighting",
        "url": "https://www.alibaba.com/product-detail/12V-Thick-Gel-SMD-COB-LED_1601761673367.html",
        "image": "https://s.alicdn.com/@sc04/kf/Ha91da48692874ebe924c25820d5f2fa2X.png_300x300.png",
        "images": [
          "https://s.alicdn.com/@sc04/kf/Ha91da48692874ebe924c25820d5f2fa2X.png_300x300.png",
          "https://s.alicdn.com/@sc04/kf/H3614cfe19f1e4e929f0d4c9a6e7f309ci.png_300x300.png",
          "https://s.alicdn.com/@sc04/kf/H461403a395e24795b3b97d93c070cbf31.png_300x300.png"
        ],
        "price": {
          "text": "$0.73",
          "currency": "USD",
          "min": 0.73,
          "max": 0.73
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 5 meters",
          "quantity": 5,
          "unit": "meters"
        },
        "sold_count": 122,
        "rating": 4.9,
        "review_count": 40,
        "supplier_service_score": 4.9,
        "shipping_score": 4.9,
        "supplier": {
          "company_id": "260800325",
          "name": "Shenzhen Czine Light Technology Co., Ltd.",
          "country": "CN",
          "years_on_alibaba": "5 yrs",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/Hc706d6e01b5847c8b10ff4d78690b086M.jpg",
          "url": "https://czineled.en.alibaba.com/"
        },
        "certifications": [
          "EMC",
          "LVD",
          "CE"
        ],
        "is_ad": true
      },
      {
        "product_id": "1601830114669",
        "title": "Customizable Size Flexible Neon Strip Light 24V 12V LED Rated Dimmable High CRI 80/90 Mall Bar Engineering Hotel Outdoor",
        "url": "https://www.alibaba.com/product-detail/Customizable-Size-Flexible-Neon-Strip-Light_1601830114669.html",
        "image": "https://s.alicdn.com/@sc04/kf/H85dc27cd82594d97a8f1b3ce810996c8Z.jpg_300x300.jpg",
        "images": [
          "https://s.alicdn.com/@sc04/kf/H85dc27cd82594d97a8f1b3ce810996c8Z.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/H8b1b01dff61643c5aa5485507c032b99A.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/Hfb87d0cd618d49529c6e45bb85450ec28.jpg_300x300.jpg"
        ],
        "price": {
          "text": "$2.80-3",
          "currency": "USD",
          "min": 2.8,
          "max": 3
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 50 meters",
          "quantity": 50,
          "unit": "meters"
        },
        "sold_count": 110,
        "rating": null,
        "review_count": 0,
        "supplier_service_score": null,
        "shipping_score": null,
        "supplier": {
          "company_id": "292562069",
          "name": "Shenzhen Yachengchuang Optoelectronics Co., Ltd.",
          "country": "CN",
          "years_on_alibaba": "1 yr",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/H4f6b91a9b53e4fd0a4fb2c42f7ca00e5c.jpg",
          "url": "https://yccled.en.alibaba.com/"
        },
        "certifications": [
          "Declaration of Conformity",
          "RoHS",
          "CE"
        ],
        "is_ad": false
      },
      {
        "product_id": "1601899945226",
        "title": "5050 Addressable RGB LED WS2812/SK6812 Built-in IC Strip Lighting Gaming Peripherals Smart Home Automotive Ambiance CE Certified",
        "url": "https://www.alibaba.com/product-detail/5050-Addressable-RGB-LED-WS2812-SK6812_1601899945226.html",
        "image": "https://s.alicdn.com/@sc04/kf/Ha88d2d470cd04e5a9e661bcb13e31701Q.jpg_300x300.jpg",
        "images": [
          "https://s.alicdn.com/@sc04/kf/Ha88d2d470cd04e5a9e661bcb13e31701Q.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/H971dc9825fab4d0bbe6b12b65d790f823.jpg_300x300.jpg",
          "https://s.alicdn.com/@sc04/kf/Hcfeca73176df467eaac9ab059de45034A.jpg_300x300.jpg"
        ],
        "price": {
          "text": "$0.02-0.03",
          "currency": "USD",
          "min": 0.02,
          "max": 0.03
        },
        "promotion_price": null,
        "currency": "USD",
        "moq": {
          "text": "Min. order: 1,000 pieces",
          "quantity": 1000,
          "unit": "pieces"
        },
        "sold_count": null,
        "rating": null,
        "review_count": 0,
        "supplier_service_score": null,
        "shipping_score": null,
        "supplier": {
          "company_id": "292479216",
          "name": "Shenzhen Shengtian Optoelectronic Technology Co., Ltd.",
          "country": "CN",
          "years_on_alibaba": "1 yr",
          "verified": true,
          "logo": "https://sc02.alicdn.com/kf/Hf9ca56bea58e4dbd9ec05948e6896aeeK.jpg",
          "url": "https://stgdled.en.alibaba.com/"
        },
        "certifications": [
          "Declaration of Conformity",
          "CE"
        ],
        "is_ad": true
      }
    ],
    "query": "led strip",
    "page": 1,
    "page_size": 48,
    "total_estimate": 16201,
    "has_more": true,
    "next_page": 2
  }
}
Real response, fetched from the live endpoint with the parameters on the left — trimmed to the first few rows, with seller names left out. Press Try it for the untrimmed response.

How the Alibaba.com B2B Wholesale API works

Alibaba.com B2B Wholesale is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 184 engines.

02
Call
POST /alibaba/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 credit per call

Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

From a keyword to a number you can actually quote against

A search row shows a price, and it is not the price you will pay. Wholesale prices in bands, and the first band starts at the minimum order.

01search
POST/alibaba/v1/search
{"query": "led strip", "verified_supplier": true}

Rows come back with a from-price and the minimum order beside it, so you can drop anything whose MOQ is past what you buy before opening a single listing.

02product_detail
POST/alibaba/v1/product_detail
{"product_id": "1600104532932"}

Now the ladder: each band with its quantity range and its own unit price, the production lead time by quantity, and the supplier's country, years on the platform and verification flags.

Two calls and you hold a quotable number — a unit price tied to a quantity you can actually order, from a company you can check.

request
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 envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "alibaba",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}

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'.

FieldWhat it holdsMeasured value
product_idAlibaba'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 tier5-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 card0.69 and 0.76 for the listing above, matching both ends of its ladder
moq.quantity + moq.unitThe number and the unit it is counted in. Not normalized, singular and plural both occur5 and "meters". One 48-row page held meters, meter, pieces, piece, sets, bags
supplier.company_idAlibaba's numeric company id, returned as a string"239980482", Shenzhen Ledodm Lighting Co., Ltd., country CN
supplier.verifiedThe on-site Verified Supplier programme. A real boolean, never nulltrue on 32 of the 48 rows of the default 'led strip' page
variants[].sku_idPer-variant id from the attribute matrix. Its own price field is null on every variant"105939040337", stock 9999999, in_stock true
supplier_countryISO-2 code of the supplier, applied server-sideIN returned 48 of 48 IN rows, TR returned 48 of 48 TR rows
is_adPaid placement in the search gridtrue on 23 of the 48 rows for 'led strip'
rfq_idId 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'.

What a wholesale row covers, and who is behind it

Measured on a keyword search, a listing opened in full, the buying-request board, and a deliberate nonsense query.

There is no single price, and the API does not invent one

Open a laddered listing and the flat price field is null on purpose: what comes back is a ladder of quantity bands, each with its own unit price, next to the minimum order and the lead time for that quantity. The number on a search row is where the ladder starts, not what one unit costs.

The minimum order is part of the offer, not a footnote

Every row and every listing carries the minimum order as a quantity and a unit — meters, pieces, pairs, sets. A unit price that looks unbeatable frequently begins at hundreds of units, and that is visible before you open anything.

A row is a company, not a shelf

Each offer carries the supplier behind it: the company, its country and city, how many years it has been on the platform, whether it is a manufacturer or a trading company, its verification and gold-supplier flags and its service and shipping scores. Two rows for the same product are two different companies quoting you.

An empty search does not exist here, so do not test relevance with one

A deliberate keyboard-mash query came back with a full page of unrelated goods and a result estimate in the thousands — Alibaba's own search always finds something. Emptiness is not how you detect a bad query on this source. Rows do carry an is-advert flag, so the paid placements can be dropped yourself.

The buying-request board is truncated by the board itself

Each request carries the buyer's own description, and on the board that text is cut short — the response flags which ones were truncated rather than passing the stub off as the whole request. Alongside it sits Alibaba's own remaining-quotes counter and how long ago the request was posted.

What people build with Alibaba.com B2B Wholesale

The jobs this data is most often used for.

3

endpoints

1

credit per call

01

Pricing and assortment teams use Alibaba.com B2B Wholesale to search alibaba.com wholesale listings by keyword.

02

Brand-protection teams use Alibaba.com B2B Wholesale to get full wholesale detail for one alibaba.com listing.

03

Retail analysts use Alibaba.com B2B Wholesale to search live buying requests (RFQs) posted by Alibaba buyers.

What Alibaba.com B2B Wholesale data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 184 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Alibaba.com B2B Wholesale.

Get a free key →
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, 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 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.

16 More APIs APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Alibaba.com B2B Wholesale, you are one call away from the rest of the category — no second contract, no second integration.

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 183 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-08-30.