# 闲鱼 API

> 二手商品：搜索、标价和卖家。

网页版：https://okdata.online/zh/apis/xianyu/

2 个接口，每次 $0.022 到 $0.022。地区：中国大陆。不需要闲鱼账号或 Cookie。

| 接口 | ID | 返回 | 价格 |
|---|---|---|---|
| [闲鱼商品搜索](https://okdata.online/zh/apis/xianyu/products/search/) | `xianyu.products.search` | Product[] | $0.022/次 · 每页约 10 个商品 |
| [闲鱼商品详情](https://okdata.online/zh/apis/xianyu/products/get/) | `xianyu.products.get` | Product | $0.022/次 |

## 适合做什么

- 选品定价: `xianyu.products.search`, `xianyu.products.get`
- 热点研究: `xianyu.products.search`

## 概览

闲鱼的 2 个接口，覆盖商品，每次 $0.022 起。不需要闲鱼账号或 Cookie。

分类：[电商](https://okdata.online/zh/categories/commerce/)

- **接口**：2 个接口. 分 1 组，返回格式统一。
- **最低价格**：$0.022 起. 每次，约 ¥0.16。
- **数据时效**：当场取. 调用时从平台读取。
- **月费**：$0. 没有订阅，也没有最低消费。

- [免费开始](https://okdata.online/zh/console/)
- 试一次：[闲鱼商品搜索](https://okdata.online/zh/apis/xianyu/products/search/)
- 在 Claude、Cursor 等智能体里用闲鱼：[闲鱼 MCP](https://okdata.online/zh/mcp/xianyu/)

## 按分组看接口

### 商品 (2)

| 接口 | 请求 | 返回 | 价格 |
|---|---|---|---|
| [商品搜索](https://okdata.online/zh/apis/xianyu/products/search/) | `GET /v1/xianyu/products/search` | 商品列表 | $0.022/次 |
| [商品详情](https://okdata.online/zh/apis/xianyu/products/get/) | `GET /v1/xianyu/products/get` | 商品 | $0.022/次 |

- [闲鱼 API 价格](https://okdata.online/zh/pricing/xianyu/)
- [在 AI 里用闲鱼数据（MCP）](https://okdata.online/zh/mcp/xianyu/)
- [运行状态](https://okdata.online/zh/status/)

## 大家拿闲鱼数据做什么

- [选品定价](https://okdata.online/zh/solutions/product-research/)：“卖得好的都卖多少钱，买家在吐槽什么？” [商品搜索](https://okdata.online/zh/apis/xianyu/products/search/) $0.022、[商品详情](https://okdata.online/zh/apis/xianyu/products/get/) $0.022
- [热点研究](https://okdata.online/zh/solutions/trend-research/)：“今天热搜上有什么能借势的？” [商品搜索](https://okdata.online/zh/apis/xianyu/products/search/) $0.022

## 三步开始

1. 拿一把 key：[打开控制台](https://okdata.online/zh/console/)。新 key 自带 $0.10 试用额度，不用绑卡。
2. 把这句话贴给你的 AI（换成你的 key），或者自己调接口：

   > 按 https://okdata.online/agents.md 的步骤，帮我在这个 agent 里装好 okdata。我的 okdata API Key：okd_…，请妥善保存，之后调用 okdata 都用它。

3. 调第一次（闲鱼商品搜索）。结果在 data.items，下一页游标在 page.next_cursor，扣费在 meta.billing.amount。

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

## 关于闲鱼 API 的常见问题

### 闲鱼 API 怎么收费？

2 个接口各自定价，每次 $0.022，最便宜的是闲鱼商品详情，$0.022。从预付余额按次扣费，没有订阅。请求到了数据源的调用，返回为空、查不到或出错也照常计费；参数错误这类还没请求数据源就被拦下的不扣费。

### 需要闲鱼账号或 Cookie 吗？

不需要。用一个 okdata key 调 https://api.okdata.online，拿回的是闲鱼的公开数据，不涉及闲鱼账号、Cookie 或扫码登录。

### 数据是实时的吗？

每个接口都在你调用时当场读取闲鱼，不读旧副本。

### AI 智能体能直接用闲鱼 API 吗？

可以。接上 https://api.okdata.online/mcp 这个 MCP 服务，find 工具会列出这 2 个接口和价格，call 工具用你的 key 调用。

### 可以免费试吗？

新账号送 $0.10 试用额度，不用绑卡，够调 4 次闲鱼商品详情。

## 更多闲鱼内容

- [商品详情接口](https://okdata.online/zh/roles/products-get/)
- [商品搜索接口](https://okdata.online/zh/roles/products-search/)

## 其他平台

[抖音 API](https://okdata.online/zh/apis/douyin/) · [小红书 API](https://okdata.online/zh/apis/xiaohongshu/) · [微信公众号 API](https://okdata.online/zh/apis/wechat_mp/) · [B站 API](https://okdata.online/zh/apis/bilibili/) · [微博 API](https://okdata.online/zh/apis/weibo/) · [TikTok API](https://okdata.online/zh/apis/tiktok/) · [X（推特） API](https://okdata.online/zh/apis/x/) · [YouTube API](https://okdata.online/zh/apis/youtube/) · [Meta 广告库 API](https://okdata.online/zh/apis/meta/) · [Google 广告透明中心 API](https://okdata.online/zh/apis/google/) · [Instagram API](https://okdata.online/zh/apis/instagram/) · [Reddit API](https://okdata.online/zh/apis/reddit/) · [快手 API](https://okdata.online/zh/apis/kuaishou/) · [知乎 API](https://okdata.online/zh/apis/zhihu/) · [微信视频号 API](https://okdata.online/zh/apis/wechat_channels/) · [微信搜一搜 API](https://okdata.online/zh/apis/wechat/) · [Telegram API](https://okdata.online/zh/apis/telegram/) · [亚马逊 API](https://okdata.online/zh/apis/amazon/) · [速卖通 API](https://okdata.online/zh/apis/aliexpress/) · [淘宝天猫 API](https://okdata.online/zh/apis/taobao/) · [1688 API](https://okdata.online/zh/apis/alibaba_1688/) · [抖音电商 API](https://okdata.online/zh/apis/douyin_shop/)
