一、接口摘要
闲鱼商品详情API是阿里巴巴旗下二手交易平台闲鱼提供的开发者接口，主要用于通过商品ID获取商品的详细信息。该接口支持多种开发语言调用，返回JSON格式数据，包含商品基本信息、卖家信息、图片视频等内容。
二、公开商品详情查询 API（数据服务商，适合选品、监控、比价，你业务常用）
1.主流接口名称：goodfish.item_get
- 请求方式：GET
- 入参核心：
num_iid（Goofish 商品 ID，由搜索接口 goodfish.item_get 拿到） - 公共参数：key、secret、api_name=goodfish.item_get
- 返回字段：标题、售价、原价、sku、详情描述、多图、类目 category_id/parent_id、卖家信息、发布时间、浏览收藏、商品属性 props 等
2.公共地址: http://o0b.cn/WSMpp3
三、Python标准调用示例
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function import requests
# 配置参数 API_URL = "http://o0b.cn/ibrad "
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/item_get/?key=<您自己的apiKey>&num_iid=123456" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)
代码实现了一个完整的闲鱼API调用类，主要功能包括：可返回核心字段
- 基础：num_iid、title、price、original_price、pic_url、desc
- 类目：category_id、parent_id、category_name（正好你前面问的三个字段）
- 属性：商品属性 prop（对标淘宝 taobao.itempropvalues.get）
- 卖家：seller_nick、seller_id、信用信息
- 规格：sku 列表、库存、运费
四、结余
闲鱼商品详情API为开发者提供了标准化的商品数据获取渠道，支持多种应用场景开发。在实际使用中，开发者需要关注官方文档更新，确保接口调用的准确性和合规性。同时需要注意API调用频率限制，合理处理错误响应，保证应用的稳定运行。
五、补充区分
- Goofish：海外闲鱼（香港 / 东南亚），独立站点，商品体系独立
- Xianyu： 国内闲鱼，二者接口不能互通
