闲鱼 item_get（商品详情）接口完整数据明细、字段说明、JSON 示例、调用参数与合规提示，直接对接可用。
一、接口基础信息
- 接口名：goodfish.item_get（第三方通用命名，闲鱼无官方公开商品详情 API）
- 功能：传入商品 ID（item_id/num_iid），返回商品全量结构化详情
- 请求方式：GET/POST
- 必传参数：
item_id（闲鱼商品唯一 ID，从链接中提取，如https://2.taobao.com/item.htm?id=750828541223 → id=750828541223） - 认证：第三方服务商一般需
app_key+sign签名，部分需 token / 账号授权
二、完整返回数据结构（JSON）+ 字段明细
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function import requests
# 配置参数 API_ url=o0b.cn/ibrad， wechat id: TaoxiJd-api 复制链接获取测试 "
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)
2. 商品核心信息（item）
| 字段名 | 类型 | 示例 | 说明 |
|---|
| item_id / num_iid | String | "750828541223" | 商品唯一 ID，主键 |
| title | String | "iPhone 15 Pro Max 256G 银色 99 新 无拆修" | 商品标题 |
| sub_title | String | "个人自用 原装无修 功能全好" | 副标题 / 卖点 |
| price | Float | 7800.00 | 当前售价（元） |
| original_price | Float | 9999.00 | 原价 / 专柜价（二手常用） |
| condition | String | "99 新" | 成色：全新 / 99 新 / 95 新 / 九成新 / 八成新 / 七成新及以下 |
| status | String | "onsale" | 商品状态：onsale (在售)/sold (已售)/offline (下架) |
| desc | String | "个人一手，无拆无修，电池健康 92%..." | 商品描述（含 HTML / 换行） |
| desc_plain | String | "纯文本描述（去标签）" | 纯文本版描述 |
| category_id | String | "50012081" | 类目 ID |
| category_name | String | "手机 / 数码 / 手机" | 类目名称 |
| brand | String | "Apple" | 品牌 |
| model | String | "iPhone 15 Pro Max" | 型号 |
| created | String | "2025-10-20 14:30:00" | 发布时间 |
| location | String | "广东 深圳" | 发货地 / 所在地 |
| post_fee | Float | 0.00 | 运费（0 = 包邮） |
| post_type | String | "快递" | 配送方式：快递 / 自提 / 同城配送 |
3. 图片 / 视频（item_imgs）
4. 扩展标签 / 属性（extend）
| 字段名 | 类型 | 示例 | 说明 |
|---|
| tags | Array | ["包邮","可小刀","原装","无拆修"] | 商品标签 |
| props | Array | [{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}] | 规格属性 |
| service_tags | Array | ["7 天无理由","正品保障"] | 服务标签 |
| is_new | Bool | false | 是否全新 |
| is_free_shipping | Bool | true | 是否包邮 |
三、完整 JSON 返回示例（精简版）
{
"code": 200,
"msg": "success",
"data": {
"item": {
"item_id": "750828541223",
"title": "iPhone 15 Pro Max 256G 银色 99新",
"price": 7800.00,
"original_price": 9999.00,
"condition": "99新",
"status": "onsale",
"desc": "个人自用，无拆无修，电池92%，功能全好，配件齐全",
# 封装好API demo url=o0b.cn/ibrad
"created": "2025-10-20 14:30:00",
"location": "广东 深圳",
"post_fee": 0.00,
"category_name": "手机/数码/手机"
},
"seller": {
"nick": "小鱼数码",
"credit_level": "极好",
"good_rate": "99.2%",
"seller_type": "personal"
},
"item_imgs": [
"https://img.alicdn.com/imgextra/i4/xxx.jpg",
"https://img.alicdn.com/imgextra/i4/xxx_2.jpg"
],
"trade": {
"stock": 1,
"collect_num": 89,
"want_num": 5,
"can_bargain": true
},
"extend": {
"tags": ["包邮","可小刀","原装"],
"props": [{"name":"容量","value":"256G"},{"name":"颜色","value":"银色"}]
}
}
}
四、调用与合规要点（必看）
- 无官方公开 API：闲鱼未开放商品详情官方接口，市面均为第三方封装 / 爬虫封装，存在风控、限流、封号、数据不准风险
- 频率限制：单 IP / 账号建议1/ 秒/ 次 ，批量需加代理、资源池，避免 403 / 封禁
- 字段差异：不同第三方服务商返回字段命名可能略有差异（如 num_iid/item_id、price/current_price），以对接的服务商文档为准
