# Xianyu (Goofish) API

> Second-hand listings: search, asking prices and sellers.

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

2 endpoints, $0.022 to $0.022 per call. Region: Mainland China. No Xianyu (Goofish) login or cookies needed.

| Endpoint | ID | Returns | Price |
|---|---|---|---|
| [Xianyu listing search](https://okdata.online/apis/xianyu/products/search/) | `xianyu.products.search` | Product[] | $0.022 per call · about 10 products per page |
| [Xianyu listing details](https://okdata.online/apis/xianyu/products/get/) | `xianyu.products.get` | Product | $0.022 per call |

## Good for

- Product research: `xianyu.products.search`, `xianyu.products.get`
- Trend research: `xianyu.products.search`

## At a glance

2 Xianyu endpoints covering products, from $0.022 a call. No Xianyu account or cookie needed.

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

- **Endpoints**: 2 endpoints. In 1 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: [Xianyu listing search](https://okdata.online/apis/xianyu/products/search/)
- Xianyu in Claude, Cursor and other agents: [Xianyu MCP](https://okdata.online/mcp/xianyu/)

## Endpoints by group

### Products (2)

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

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

## What people do with Xianyu data

- [Product research](https://okdata.online/solutions/product-research/): “What do the best sellers cost, and what do buyers complain about?” [Listing search](https://okdata.online/apis/xianyu/products/search/) $0.022, [Listing details](https://okdata.online/apis/xianyu/products/get/) $0.022
- [Trend research](https://okdata.online/solutions/trend-research/): “What is trending today that we could ride?” [Listing search](https://okdata.online/apis/xianyu/products/search/) $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 (Xianyu listing 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/xianyu/products/search" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'query=咖啡机'
```

## Questions about the Xianyu API

### What does the Xianyu API cost?

Each of the 2 endpoints has its own price, $0.022 a call; the cheapest is Xianyu listing 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 Xianyu account or cookie?

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

### How fresh is the data?

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

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

Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 2 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 Xianyu listing details.

## More about Xianyu

- [Product detail API](https://okdata.online/roles/products-get/)
- [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/) · [1688 API](https://okdata.online/apis/alibaba_1688/) · [Douyin Shop API](https://okdata.online/apis/douyin_shop/)
