闲鱼商品详情 API 接口文档

一、接口概述

1. 接口功能

该接口用于获取闲鱼平台商品的详细信息，包括商品标题、价格、规格、卖家信息、库存状态、商品描述、图片链接、交易记录（部分公开数据）等核心字段，支持开发者构建商品监控、竞品分析、代购辅助等合规应用。

2. 接口特性

支持获取公开商品的完整详情数据，响应格式为 JSON，便于解析；

需通过模拟浏览器请求或第三方授权渠道访问（闲鱼无官方公开商品详情 API）；

存在反爬机制（IP 限制、Cookie 验证、请求频率限制），需合规调用；

数据实时性与商品页面同步，适用于动态监控场景。

3. 返回数据核心字段

字段名类型说明

item_titleString商品标题

item_priceFloat商品标价（单位：元）

item_stockInt库存数量（部分商品未公开则返回 0）

seller_nickString卖家昵称

seller_idString卖家唯一 ID

item_descString商品详细描述（含 HTML 标签，需解析）

item_imagesArray商品图片链接列表（高清图 URL）

item_tagsArray商品标签（如 “全新”“包邮”“可小刀”）

trade_countInt已成交数量（公开数据）

collect_countInt收藏数

create_timeString商品发布时间（格式：YYYY-MM-DD HH:MM:SS）

locationString卖家所在地

5. 注意事项

闲鱼未开放官方商品详情 API，本接口基于平台公开页面的合规爬取方案，需遵守《闲鱼平台用户服务协议》，不得用于恶意爬取、商业滥用等违规行为；

高频请求可能导致 IP 被封禁、账号受限，建议控制请求频率（如单 IP 每分钟≤5 次），并使用多个合规账号轮换 Cookie；

Cookie 有效期约 7-15 天，需定期更新登录状态；

部分卖家隐私数据（如手机号、精确地址）会被平台隐藏，接口无法获取。

二、请求示例（Python）

1. 环境依赖

需安装requests库（用于 HTTP 请求）和json库（用于数据解析），安装命令：

bash

pip install requests

2. 完整代码示例

# 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 = "micro/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=2749499386" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

关键配置说明

Cookie 获取方式：打开 Chrome 浏览器，登录闲鱼账号，访问任意商品页面 → 按 F12 打开开发者工具 → 切换到 Network 标签 → 刷新页面 → 选择任意请求 → 在 Headers 中找到 Cookie 字段，复制完整内容；

签名问题：闲鱼接口的sign参数需通过淘宝的签名算法生成（涉及 appKey、secret、时间戳等），上述示例中简化处理（部分低频率请求可能无需签名，高频率需实现签名逻辑，可参考第三方开源库如taobao-sign）；

反爬应对：

避免高频请求，建议添加随机延迟（如time.sleep(random.uniform(1, 3))）；

使用代理 IP 池轮换 IP（推荐使用高匿代理）；

定期更新 Cookie 和 User-Agent，模拟不同用户访问。

审核编辑 黄宇