# 1688 API

> China's wholesale marketplace: offers, tiered prices, suppliers and buyer reviews.

Canonical page: https://okdata.online/apis/alibaba_1688/

4 endpoints, $0.022 to $0.022 per call. Region: Mainland China. No 1688 login or cookies needed.

| Endpoint | ID | Returns | Price |
|---|---|---|---|
| [1688 product search](https://okdata.online/apis/alibaba_1688/products/search/) | `alibaba_1688.products.search` | Product[] | $0.022 per call · about 20 products per page |
| [1688 product details](https://okdata.online/apis/alibaba_1688/products/get/) | `alibaba_1688.products.get` | Product | $0.022 per call |
| [1688 product reviews](https://okdata.online/apis/alibaba_1688/products/reviews/list/) | `alibaba_1688.products.reviews.list` | Review[] | $0.022 per call · about 10 reviews per page |
| [1688 supplier products](https://okdata.online/apis/alibaba_1688/shops/products/list/) | `alibaba_1688.shops.products.list` | Product[] | $0.022 per call · about 20 products per page |

## Good for

- Product research: `alibaba_1688.products.search`, `alibaba_1688.products.get`, `alibaba_1688.products.reviews.list`, `alibaba_1688.shops.products.list`
- Competitor monitoring: `alibaba_1688.products.search`, `alibaba_1688.shops.products.list`
- Word of mouth: `alibaba_1688.products.reviews.list`

## At a glance

4 1688 endpoints covering products and shops, from $0.022 a call. No 1688 account or cookie needed.

Categories: [E-commerce](https://okdata.online/categories/commerce/)

- **Endpoints**: 4 endpoints. In 2 groups, one response format.
- **Lowest price**: From $0.022. A call, paid from a prepaid balance.
- **Freshness**: Live. Read from the platform when you call.
- **Monthly fee**: $0. No subscription or minimum spend.

- [Start free](https://okdata.online/console/)
- Try one: [1688 product search](https://okdata.online/apis/alibaba_1688/products/search/)
- 1688 in Claude, Cursor and other agents: [1688 MCP](https://okdata.online/mcp/alibaba_1688/)

## Endpoints by group

### Products (3)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Product search](https://okdata.online/apis/alibaba_1688/products/search/) | `GET /v1/alibaba_1688/products/search` | Product[] | $0.022 per call |
| [Product details](https://okdata.online/apis/alibaba_1688/products/get/) | `GET /v1/alibaba_1688/products/get` | Product | $0.022 per call |
| [Product reviews](https://okdata.online/apis/alibaba_1688/products/reviews/list/) | `GET /v1/alibaba_1688/products/reviews/list` | Review[] | $0.022 per call |

### Shops (1)

| Endpoint | Request | Returns | Price |
|---|---|---|---|
| [Supplier products](https://okdata.online/apis/alibaba_1688/shops/products/list/) | `GET /v1/alibaba_1688/shops/products/list` | Product[] | $0.022 per call |

- [1688 API pricing](https://okdata.online/pricing/alibaba_1688/)
- [1688 in your AI (MCP)](https://okdata.online/mcp/alibaba_1688/)
- [Live status](https://okdata.online/status/)

## What people do with 1688 data

- [Product research](https://okdata.online/solutions/product-research/): “What do the best sellers cost, and what do buyers complain about?” [Product search](https://okdata.online/apis/alibaba_1688/products/search/) $0.022, [Product details](https://okdata.online/apis/alibaba_1688/products/get/) $0.022, [Product reviews](https://okdata.online/apis/alibaba_1688/products/reviews/list/) $0.022
- [Competitor monitoring](https://okdata.online/solutions/competitor-monitoring/): “What did our competitors post this week, and what took off?” [Product search](https://okdata.online/apis/alibaba_1688/products/search/) $0.022, [Supplier products](https://okdata.online/apis/alibaba_1688/shops/products/list/) $0.022
- [Word of mouth](https://okdata.online/solutions/word-of-mouth/): “What do buyers complain about most?” [Product reviews](https://okdata.online/apis/alibaba_1688/products/reviews/list/) $0.022

## Start in three steps

1. Get a key: [open the console](https://okdata.online/console/). A new key comes with $0.10 to try, no card.
2. Connect your AI with this sentence (swap in your key), or call the API yourself:

   > Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.

3. Make the first call (1688 product search). Items arrive in data.items, the next page in page.next_cursor, the charge in meta.billing.amount.

```bash
curl -G "https://api.okdata.online/v1/alibaba_1688/products/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=咖啡磨豆机'
```

## Questions about the 1688 API

### What does the 1688 API cost?

Each of the 4 endpoints has its own price, $0.022 a call; the cheapest is 1688 product details at $0.022. You pay per call from a prepaid balance, with no subscription. A call that reaches the data source is charged even when it comes back empty, not found or failed; one stopped before that, such as for bad parameters, is free.

### Do I need a 1688 account or cookie?

No. You call https://api.okdata.online with one okdata key and get public 1688 data back; no 1688 account, cookie or QR login is involved.

### How fresh is the data?

Every endpoint reads 1688 at the moment you call; nothing is served from an old copy.

### Can my AI agent use the 1688 API?

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 4 endpoints with their prices, and its call tool runs them on your key.

### Can I try it for free?

New accounts get $0.10 of trial credit with no card: enough for 4 calls to 1688 product details.

## More about 1688

- [Product detail API](https://okdata.online/roles/products-get/)
- [Product reviews API](https://okdata.online/roles/products-reviews-list/)
- [Product search API](https://okdata.online/roles/products-search/)

## Other platforms

[TikTok API](https://okdata.online/apis/tiktok/) · [YouTube API](https://okdata.online/apis/youtube/) · [Instagram API](https://okdata.online/apis/instagram/) · [X (Twitter) API](https://okdata.online/apis/x/) · [Reddit API](https://okdata.online/apis/reddit/) · [Amazon API](https://okdata.online/apis/amazon/) · [AliExpress API](https://okdata.online/apis/aliexpress/) · [Meta Ad Library API](https://okdata.online/apis/meta/) · [Google Ads Transparency API](https://okdata.online/apis/google/) · [Telegram API](https://okdata.online/apis/telegram/) · [Douyin API](https://okdata.online/apis/douyin/) · [Xiaohongshu (RedNote) API](https://okdata.online/apis/xiaohongshu/) · [WeChat Official Accounts API](https://okdata.online/apis/wechat_mp/) · [Bilibili API](https://okdata.online/apis/bilibili/) · [Weibo API](https://okdata.online/apis/weibo/) · [Kuaishou API](https://okdata.online/apis/kuaishou/) · [Zhihu API](https://okdata.online/apis/zhihu/) · [WeChat Channels API](https://okdata.online/apis/wechat_channels/) · [WeChat Search API](https://okdata.online/apis/wechat/) · [Taobao & Tmall API](https://okdata.online/apis/taobao/) · [Xianyu (Goofish) API](https://okdata.online/apis/xianyu/) · [Douyin Shop API](https://okdata.online/apis/douyin_shop/)
