1688 API

Search 1688.com wholesale offers and read price tiers, SKUs, stock and suppliers as JSON.

The API.SH 1688 API turns public 1688.com pages into structured JSON. Search wholesale offers by keyword, sorted by sales or price with a price range, and get each offer's price in CNY, monthly sales, brand, tags and supplier. Read one offer in full with quantity price tiers, minimum order, stock, every SKU with attributes and price, ratings, shipping and the supplier's service score.

Get a free API key Try it in the playground

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

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the 1688 API

Sourcing and supplier discovery

Search a product keyword, sort by sales or price and compare suppliers by years on the platform and power-merchant flag.

/search /product

Wholesale price and MOQ comparison

Read quantity price tiers and minimum order for each offer to work out your landed cost at different volumes.

/product

Dropshipping research

Use search tags such as one-piece dropshipping and 48-hour shipping, with monthly sales, to find products that suit your model.

/search

Variant and stock checks

Read every SKU of an offer with attributes, price and stock to check which options are available.

/product

Supplier quality screening

Check an offer's rating score, good rate, review tags and the supplier's service score and repeat-buyer rate before you order.

/product

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

Search and discovery1

1688 product search

/1688/v1/search

$1 · $2 PAYG

1 credit

Products, listings and places1

1688 product details

/1688/v1/product

$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"

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 482 platforms.
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 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official 1688 API

1688 belongs to Alibaba, whose open platform offers official APIs for registered developers, who create an app and get keys. API.SH needs no 1688 developer account: it reads public search and product pages and returns them in one JSON format. It reads data only and does not place orders.

Skip building and maintaining your own 1688 scraper or paying for separate Apify actors: API.SH gives you one key, one JSON shape and a fixed price per 1,000 calls.

1688 API questions

What 1688 data can I get?+

Wholesale keyword search with prices, sales and suppliers (/1688/v1/search) and one offer with price tiers, minimum order, SKUs, stock, ratings, shipping and supplier details (/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. Alibaba's open platform (open.1688.com) offers official access to 1688 data, and you need to register, create an app and get keys, with guides mostly in Chinese. API.SH needs none of that and reads public pages only, so it cannot place orders.

Do I need a 1688 account or login?+

No. API.SH reads public 1688 pages only. No endpoint uses a login, cookies or anyone's account.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /1688/v1/search with q set to a product keyword, or /1688/v1/product with an offer_id or url. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

What currency are 1688 prices in?+

Prices are in CNY, including the quantity price tiers and each SKU's price. Convert them yourself with your own exchange rate and add shipping to get a landed cost.

Is there a free 1688 API or scraper I can use from Python?+

With API.SH you get 1,000 free credits every month to try 1688 search and product data. It is a plain HTTPS API with a Python SDK, and pagination works by passing next_page back as page, with 40 offers per search page.