1688+API.SH

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
1688 product search
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}
1 credit · $1 per 1,000 calls

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 product details/1688/v1/product
offer_id1037138366523urlhttps://detail.1688.com/offer/10…title秒变苹果17手机壳适用iPhone16高级感15promax个性…currencyCNYunit个min_order_quantity2stock14457sold_count541sales_text一年内500+category_id1046694description_urlhttps://itemcdn.tmall.com/1688of…
price_range[]price · min_quantity
video[]coverUrl · videoId · state · title · videoUrl
sku_props[]name · values
skus[]sku_id · spec_id · attributes · price · discount_price · stock · sold
1688 product search/1688/v1/search
query手机壳page1next_page2count40currencyCNY
items[]rank · offer_id · url · title · image · price · currency · sales_text · monthly_sales · brand · tags · shop

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

Search and discovery1
1688 product search
/1688/v1/search
params q +5 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places1
1688 product details
/1688/v1/product
params none required +2 optionaldocstry
$1 · $2 PAYG
1 credit

Call the 1688 API

1688 product search: GET https://api.api.sh/1688/v1/search

curl "https://api.api.sh/1688/v1/search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 918 platforms.
Get a free API key