一、摘要
闲鱼未对外开放官方的商品列表查询 API，本指南基于对闲鱼网页端 / 移动端请求的逆向分析，提供非官方的商品列表数据获取思路及 Python 实现示例。内容仅用于技术学习与研究，使用时需严格遵守闲鱼平台《用户协议》及相关法律法规，禁止商用、恶意爬取或滥用数据。
二、接口概述
1. 接口核心信息
| 项 | 说明 |
|---|---|
| 请求方式 | GET（主流，网页端 / 移动端通用） |
| 核心 URL | 正式环境：c0b.cc/R4rbK2 (前往体验接口测试，Taobaoapi2014添加V获取） |
| 数据返回格式 | 网页端默认返回 HTML（需解析），移动端部分接口返回 JSON（易解析） |
| 权限要求 | 无需开发者认证，但部分请求需携带 Cookie（登录态），否则数据会受限（如仅返回少量商品） |
2. 核心请求参数
| 参数名 | 必填 | 说明 |
|---|---|---|
| keyword | 是 | 商品搜索关键词（如 “二手笔记本”） |
| page | 否 | 页码，默认 1，每页约 20 条商品 |
| sort | 否 | 排序方式：default（默认）、price_asc（价格升序）、price_desc（价格降序） |
| region | 否 | 地区筛选（如 “杭州”“北京”，需与平台地区编码匹配） |
| _input_charset | 否 | 编码格式，固定为utf8 |
3. 关键请求头
模拟浏览器 / 移动端请求头是避免被风控的核心，推荐配置以下字段：
plaintext
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Referer: https://2.taobao.com/ Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8 Accept-Language: zh-CN,zh;q=0.9三、Python 请求示例
1. 环境依赖
需安装以下库（终端执行）：
bash
pip install requests beautifulsoup42. 完整代码示例（网页端 HTML 解析）
python
import requests from bs4 import BeautifulSoup import time def get_xianyu_goods(keyword, page=1, sort="default"): """ 获取闲鱼商品列表数据 :param keyword: 搜索关键词 :param page: 页码 :param sort: 排序方式 :return: 商品列表（字典列表） """ # 1. 配置请求参数和头信息 url = "https://2.taobao.com/item/list.htm" params = { "keyword": keyword, "page": page, "sort": sort, "_input_charset": "utf8" } headers = { "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36", "Referer": "https://2.taobao.com/", "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8", "Accept-Language": "zh-CN,zh;q=0.9" } try: # 2. 发送请求（添加超时和重试机制，避免请求失败） response = requests.get( url=url, params=params, headers=headers, timeout=10 ) response.raise_for_status() # 抛出HTTP错误（如403/500） response.encoding = "utf8" # 统一编码 # 3. 解析HTML提取商品信息 soup = BeautifulSoup(response.text, "html.parser") goods_list = [] # 定位商品卡片（闲鱼网页端商品卡片的class可能随版本变化，需自行验证） goods_cards = soup.select(".item-J_MouserOnverReq ") for card in goods_cards: # 提取核心信息（标题、价格、链接、卖家） title_elem = card.select_one(".J_ClickStat") price_elem = card.select_one(".price J_price") link_elem = card.select_one(".J_ClickStat") if not (title_elem and price_elem and link_elem): continue # 跳过信息不完整的商品 goods_info = { "title": title_elem.get_text().strip(), "price": price_elem.get_text().strip(), "link": "https:" + link_elem.get("href", "").strip(), "seller": card.select_one(".seller-name").get_text().strip() if card.select_one(".seller-name") else "未知" } goods_list.append(goods_info) return goods_list except requests.exceptions.RequestException as e: print(f"请求失败：{str(e)}") return [] except Exception as e: print(f"解析数据失败：{str(e)}") return [] # 测试调用 if __name__ == "__main__": # 搜索“二手手机”，获取第1页默认排序的商品 goods = get_xianyu_goods(keyword="二手手机", page=1) if goods: print(f"共获取到 {len(goods)} 条商品：") for idx, good in enumerate(goods, 1): print(f"\n{idx}. 标题：{good['title']}") print(f" 价格：{good['price']}") print(f" 链接：{good['link']}") else: print("未获取到商品数据（可能是接口变更/风控限制）")3. 代码关键说明
- 请求头配置：
User-Agent必须模拟真实浏览器，否则易被闲鱼风控拦截（返回 403 或空数据）； - HTML 解析：闲鱼网页端的商品卡片
class名称会不定期更新，若解析不到数据，需通过浏览器 F12 抓包重新定位元素； - 异常处理：添加了请求超时、HTTP 错误捕获，避免程序直接崩溃；
- 风控规避：建议在请求之间添加
time.sleep(1-3)，避免高频请求被封禁 IP。
四、结语
- 本指南提供的接口为非官方实现，URL、参数、HTML 结构均可能随闲鱼平台更新而失效，需自行定期验证和调整；
- 爬取闲鱼数据时，需控制请求频率（建议每秒不超过 1 次），避免给平台服务器造成压力，否则可能导致 IP / 账号被封禁；
- 所有数据仅可用于个人学习研究，禁止用于商业用途、数据倒卖等违规场景，否则需自行承担法律责任。
总结
- 闲鱼无官方商品列表 API，需通过模拟客户端请求 + 解析返回数据的方式获取商品列表；
- 请求时必须配置真实的请求头（尤其是
User-Agent），必要时携带登录 Cookie，同时控制请求频率规避风控； - 网页端返回 HTML 需用
BeautifulSoup解析，移动端接口（需自行抓包）返回 JSON 更易处理，但稳定性更低。
