+1688 API
Search 1688.com and pull wholesale products with quantity price tiers, MOQ, SKUs, stock, sales and supplier details as JSON.
The API.SH 1688 API returns public 1688.com (阿里巴巴 1688) data as JSON. Search returns 40 offers a page with offer id, title, image, price in CNY, monthly sales, brand, tags such as one-piece dropshipping or 48-hour shipping, supplier name and shop link, years on the platform and power-merchant flag, sorted by sales ranking or price and filtered by price range. A product gives title, unit, price tiers by quantity, minimum order, stock, units sold, images, video, category, SKU properties and every SKU with its attributes, price and stock, the rating summary (score, good rate, review count, tags), supplier details with service score and repeat-buyer rate, services, shipping and promotions.
- 2 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/1688/v1/ search
{"query": "手机壳","page": 1,"next_page": 2,"count": 40,"currency": "CNY","items": [{"rank": 1,"offer_id": "893290359232","url": "https://detail.1688.com/offer/893290359232.html","title": "适用苹果17E/16护眼凹槽滴胶手机壳iPhone18promax背卡手作素材壳","image": "https://cbu01.alicdn.com/img/ibank/O1CN015j1CpR255bd2n0jZO_!!2003997475-0-cib.jpg","price": 1.65,"currency": "CNY","sales_text": "月销2733个","monthly_sales": 2733,"brand": null,"tags": ["一件代发","48小时发货"],"shop": {"name": "深圳市优宇恒商贸企业","url": "https://ileader88.1688.com"},"years_on_platform": 13,"powerful_merchant": false},{"rank": 2,"offer_id": "681449958523","url": "https://detail.1688.com/offer/681449958523.html","title": "适用苹果18Promax高透太空壳11电镀按键iPhone16亚克力17硬壳批发","image": "https://cbu01.alicdn.com/img/ibank/O1CN01Pr54Qi1v7IfxrvlrK_!!2212968606125-0-cib.jpg","price": 2.4,"currency": "CNY","sales_text": "月销2157个","monthly_sales": 2157,"brand": "金钻甲","tags": ["7天包换"],"shop": {"name": "深圳市金钻甲科技有限公司","url": "https://17324486621.1688.com"},"years_on_platform": 5,"powerful_merchant": false},"… 38 more"],"cached": false,"credits_used": 1} What you can build with the 1688 API
Sourcing from Chinese factories
Search a product with /1688/v1/search sorted by sales, then compare price tiers, minimum order and supplier scores on each offer with /1688/v1/product to shortlist factories.
Dropshipping and reselling
Filter for one-piece dropshipping offers and pull SKUs, stock and images per variant to list products on your own store and keep stock in sync.
Cost comparison with AliExpress and Alibaba
Look up the same product on 1688, Alibaba.com and AliExpress to see the factory price, the export wholesale price and the retail price side by side.
Agent and buying-service tools
Power a buying agent's quote tool: take a customer's 1688 link and return the title, SKUs with prices and stock, minimum order and shipping info.
1688 data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
1688 API endpoints and prices
Every 1688 endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| 1688 product search /1688/ | $1 · $2 PAYG 1 credit |
| 1688 product details /1688/ | $1 · $2 PAYG 1 credit |
Call the 1688 API
1688 product search: GET https://api.api.sh/1688/
curl "https://api.api.sh/1688/v1/search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/1688/v1/search",
params={"q": "手机壳"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/1688/v1/search");
url.searchParams.set("q", "手机壳");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); # Google Sheets (API.SH add-on)
=APISH("/1688/v1/search", "q", "手机壳")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "1688" and "1688 product search".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for 1688 data
- Public data only: no 1688 login, cookies or account needed
- One key and one response shape for 1688 and 917 other platforms
- Built and maintained by API.SH, not third-party publishers
- Pay per call; errors on our side cost nothing
- No rate limits: run as many calls in parallel as you need
- Live status for every endpoint
API.SH vs the official 1688 API
1688's official APIs run on the Alibaba Open Platform (阿里巴巴开放平台): you register as a developer, create an app and get approved, mainly for store management, bulk ordering and cross-border buyer services. API.SH needs no developer account and reads public search and product pages; it does not place orders.
Third-party APIs for 1688 such as TMAPI or OpenTopCart, and scrapers on GitHub, each have their own formats and often need a Chinese account. API.SH gives 1688 search and products on one key, next to Alibaba.com and AliExpress, with blocks and retries handled for you.
1688 API questions
What 1688 data can I get?+
Product search with sales, prices and supplier info (/1688/v1/search) and product details with price tiers, SKUs, stock, ratings and supplier (/1688/v1/product).
How much does the 1688 API cost?+
Every 1688 endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.
Is there a free trial?+
Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /1688/v1/product at 1 credit each.
Is there an official 1688 API?+
Yes, on the Alibaba Open Platform, for approved developer apps. API.SH needs no app or approval.
Do I need a 1688 or Chinese account?+
No. You only need an API.SH key.
What is the 1688 China website?+
1688.com is Alibaba's domestic wholesale marketplace in China, where factories sell in bulk in CNY. Prices are often lower than on Alibaba.com, which is the export version.
Are results in English?+
Titles and attributes come in Chinese, as on the site, with prices in CNY. Pass them through a translation step if you need English.
How do I get started?+
Sign up, copy your key and call /1688/v1/search with q from the docs at https://api.sh/docs. It works from Python, JavaScript or curl, and through the SDKs, Google Sheets, Zapier, Make, n8n and the MCP server at https://api.sh/mcp.
Does the 1688 API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many 1688 calls in parallel as you need and pay only for the calls that run. If 1688 itself slows down, the call returns 503 with a retry-after header and is not charged.