一、接口概述
1. 接口作用
通过该接口(非官方)可获取闲鱼商品的核心详情信息,包括商品标题、价格、描述、卖家信息、商品图片、交易状态等。
2. 核心信息
| 项⽬ | 说明 |
|---|---|
| 请求方式 | GET(部分场景需 POST) |
| 核心请求 URL | 正式环境:c0b.cc/R4rbK2 (前往体验接口测试,Taobaoapi2014添加V获取) |
| 核心参数 | id(商品 ID,必填)、cookie(用户登录凭证,必填)、user-agent等 |
| 返回格式 | HTML(需解析)/ JSON(部分接口返回 JSON 格式) |
| 反爬机制 | 需携带登录 Cookie、校验 User-Agent、IP 频率限制、验证码校验 |
3. 重要注意事项
- 该接口为非官方接口,闲鱼平台会不定期调整接口规则,需及时适配;
- 必须使用登录后的 Cookie,否则无法获取完整商品信息;
- 请勿高频次请求,避免 IP 被封禁或账号受限;
- 仅可用于学习研究,禁止商用或恶意爬取平台数据。
二、Python 请求示例
以下示例实现 “获取闲鱼商品详情页 HTML,解析核心信息” 的功能,需提前安装requests和BeautifulSoup4库。
1. 前置准备
安装依赖库:
bash
pip install requests beautifulsoup42. 完整代码示例
# coding:utf-8 """ Compatible for python2.x and python3.x requirement: pip install requests """ from __future__ import print_function import requests # 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 " # 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=750828541223" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)关键说明
- Cookie 获取方式:打开浏览器登录闲鱼 → 进入商品详情页 → F12 打开开发者工具 → 切换到 “Network” 标签 → 刷新页面 → 找到第一个请求 → 在 “Request Headers” 中复制完整的 Cookie 字符串;
- 商品 ID 提取:闲鱼商品链接格式如
item.htm?id=123456,id=后的数字即为商品 ID; - 异常处理:代码中包含了请求超时、HTTP 错误、解析错误等异常处理,提升稳定性;
- 解析扩展:若需提取更多信息(如商品图片、交易次数等),可根据 HTML 结构调整
BeautifulSoup的解析规则。
三、结语
闲鱼商品详情接口的调用核心在于模拟真实浏览器的请求行为,同时遵守平台规则。由于接口为非官方属性,使用过程中需注意以下几点:
- 控制请求频率,建议单次请求间隔≥5 秒,避免触发平台反爬机制;
- 定期更新 Cookie(Cookie 有效期通常为几天),否则会返回登录页面;
- 仅用于个人学习和研究,严禁将爬取的数据用于商业用途,否则可能面临法律风险;
- 若平台调整接口规则(如 HTML 结构、请求参数变化),需及时修改解析逻辑和请求配置。
总结
- 闲鱼无官方商品详情 API,上述方案为基于逆向的非官方实现,仅适用于学习研究;
- 调用核心是携带登录 Cookie和模拟浏览器请求头,并通过
BeautifulSoup解析 HTML 获取信息; - 使用时需严格遵守平台规则,控制请求频率,避免账号 / IP 受限。