Other

Alibaba.com B2B Wholesale API API

Alibaba.com B2B Wholesale API API returns live Alibaba.com B2B Wholesale API data as clean JSON for alibaba.com b2b wholesale api 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….

2 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 API 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. 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 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

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 API to search alibaba.com wholesale listings by keyword.
Developer tools use Alibaba.com B2B Wholesale API to get full wholesale detail for one alibaba.com listing.
Validation workflows use Alibaba.com B2B Wholesale API to validate, enrich, classify and normalize operational data, all from one ReefAPI key and credit pool.

FAQ

Questions developers ask before integrating

What is the Alibaba.com B2B Wholesale API API?

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

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

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

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

No login to Alibaba.com B2B Wholesale API 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 API 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 API use?

Alibaba.com B2B Wholesale API 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 API 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 API a Alibaba.com B2B Wholesale API scraper?

It is the managed alternative to a DIY Alibaba.com B2B Wholesale API 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 api back as clean JSON.

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

Most Alibaba.com B2B Wholesale API 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 API

base /alibaba/v12 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 →

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
}