一、接口概述
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，模拟不同用户访问。
