很多做无货源、二手选品、货源比价的团队，习惯性地把闲鱼当成"另一个京东"，结果接上接口就懵了------SKU 是空的、属性列表是空的、价格是字符串。
这不是接口没做好，是因为两个平台的商品模型本来就不同：
|--------------|--------------------|-----------------------------------|
| 维度 | 京东 | 闲鱼 |
| 商品模型 | 一物多规格（SKU） | 一物一价，无 SKU |
| skus.sku | 通常几十条 | 空数组（正常） |
| props_list | 完整的尺码/颜色字典 | 空数组（正常） |
| 价格类型 | 数字 1290 | 字符串 "169" |
| 卖家主体 | 店铺（seller_info） | 个人（信用分/实名/常出没城市） |
| 热度指标 | total_sold（常为 0） | browseCnt / favcount（实打实） |
| 主图地址 | 协议相对 //img... | 硬编码 http://，后缀 .heic |
| 时效性 | 长期在售 | 随时被卖掉，价格随时改 |
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称（包括在请求地址中）item_search,item_get,item_search_shop等 |
| cache | String | 否 | yes,no默认yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | json,jsonu,xml,serialize,var_export返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | cn,en,ru翻译语言，默认cn简体中文 |
| version | String | 否 | API版本 |
请求参数
请求参数：num_iid=1065819280284
参数说明：num_iid:商品ID
响应参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
| item | item\[\] | 0 | 获得某鱼商品详情 | |
| desc_short | String | 0 | 商品简介 | |
| min_num | Int | 0 | 0 | |
| brand | String | 0 | 品牌名称 | |
| brandId | Int | 0 | 品牌ID | |
| title | String | 0 | 凤凰摆盘 景德镇陶瓷工艺 | 商品标题 |
| cid | Int | 0 | 50232001 | 分类ID |
| created_time | String | 0 | 2024-05-23 09:49:13 | 发布时间 |
| desc | String | 0 | 凤凰摆盘 景德镇陶瓷工艺 感兴趣的话点"我想要"和我私聊吧～ | 商品描述 |
| desc_img | Mix | 0 | \[\] | 商品描述图片 |
| detail_url | String | 0 | https://market.m.taobao.com/app/idleFish-F2e/fish-pc/web/detail.html?id=798979813110 | 商品链接 |
| express_fee | Float | 0 | 0.00 | 快递费用 |
| item_imgs | Mix | 0 | { "url": "//img14.360buyimg.com/n0/jfs/t22033/147/1051007175/85125/c44dd0df/5b1f2855Ncbe35858.jpg"} | 商品图片 |
| location | String | 0 | 潍坊 | 发货地 |
| nick | String | 0 | tbNick_ssszk | 掌柜昵称 |
| num | Int | 0 | 1 | 库存 |
| num_iid | Bigint | 0 | 798979813110 | 商品ID |
| orginal_price | Float | 0 | 58 | 原价 |
| pic_url | String | 0 | http://img.alicdn.com/bao/uploaded/i4/O1CN01LI1dl81HLsq7whyxz_!!0-fleamarket.jpg | 商品图片 |
| post_fee | Float | 0 | 0.00 | 物流费用 |
| price | Float | 0 | 20 | 价格 |
| total_price | Float | 0 | 0 | |
| suggestive_price | Float | 0 | 0 | |
| prop_imgs | Mix | 0 | {"prop_img": \[\]} | 商品属性图片列表 |
| property_alias | String | 0 | -1:-1:Python编程 从入门到实践;-1:-2:Java编程思想（第4版）; | 商品属性别名 |
| props | Mix | 0 | { "name": "品牌","value": "文韵陶瓷" } | 详细信息 |
| props_img | Mix | 0 | \[\] | 属性图片 |
| props_list | Mix | 0 | {"-1:-1": "书名:Python编程 从入门到实践"} | 商品属性 |
| props_name | String | 0 | 0:0:尺码:S;0:1:尺码:XS;0:2:尺码:M;0:3:尺码:L;0:4:尺码:XL | 商品属性名 |
| rootCatId | Int | 0 | 50020835 | 顶级分类ID |
| seller_id | Int | 0 | 781310742 | 卖家ID |
| seller_info | Mix | 0 | {"city": "潍坊","level": "","nick": "tbNick_ssszk","rate": 100,"zhuy": ""} | 卖家信息 |
| skus | Mix | 0 | {"sku": {"orginal_price": "23.62","price": "23.62","properties": "-1:-1","properties_name": "-1:-1:书名:Python编程 从入门到实践","quantity": "98","sku_id": "5349677003242"}} | 商品规格信息 |
| video | Mix | 0 | \[\] | 商品视频 |
请求示例
https://api-gw.onebound.cn/goodfish/item_get/?key=&secret=&num_iid=1065819280284&cache=no
商品详情item_get响应示例
"item": {
"num_iid": "1065819280284",
"title": "闲置小米米家喷墨打印一体机，支持打印、复印、扫描三合一，黑白",
"price": "169",
"orginal_price": "169",
"nick": "草原划水的川贝",
"pic_url": "http://img.alicdn.com/bao/uploaded/i2/1828023116/O1CN012IOVKm1YtBICIGxbj_!!4611686018427382604-53-xy_item.heic",
"detail_url": "https://market.m.taobao.com/app/idleFish-F2e/fish-pc/web/detail.html?id=1065819280284",
"item_imgs": [
{
"url": "http://img.alicdn.com/bao/uploaded/i2/1828023116/O1CN012IOVKm1YtBICIGxbj_!!4611686018427382604-53-xy_item.heic"
}
],
"cid": 50025446,
"post_fee": "0.00",
"rootCatId": 126866939,
"favcount": 231,
"created_time": "2026-07-07 18:35:30",
"desc_img": [
{
"height": "1920",
"image": "http://img.alicdn.com/bao/uploaded/i2/1828023116/O1CN012IOVKm1YtBICIGxbj_!!4611686018427382604-53-xy_item.heic",
"width": "1440"
}
],
"desc": "闲置小米米家喷墨打印一体机，支持打印、复印、扫描三合一，黑白彩色都能打，照片也能直接打印，手机APP无线连接，操作简单，家用办公都合适。\n\n成色还可以，有点使用痕迹，具体看图，功能正常。\n有黑色墨盒和电源线，到手可用。\n\n同城自提更优惠，外地可邮寄。\n闲置商品售出不退不换\u003Cimg src=\"http://img.alicdn.com/bao/uploaded/i2/1828023116/O1CN012IOVKm1YtBICIGxbj_!!4611686018427382604-53-xy_item.heic\"/\u003E\u003Cimg src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.6acc856014dbf&p=1778790145&k=70661&t=1791788385\" style=\"display:none\" /\u003E",
"seller_id": 1828023116,
"browseCnt": 3913,
"video": null,
"props_name": "",
"props_list": [],
"num": 1,
"skus": {
"sku": []
},
"seller_info": {
"title": "草原划水的川贝",
"shop_name": "草原划水的川贝",
"level": null,
"nick": "草原划水的川贝",
"xianyuSummary": "卖出过561件宝贝。男生。",
"lastVisitTime": "14分钟前来过",
"publishCity": "汕头",
"portraitUrl": "http://gtms03.alicdn.com/tps/i3/TB1LFGeKVXXXXbCaXXX07tlTXXX-200-200.png",
"xinyongiconUrl": "https://gw.alicdn.com/imgextra/i2/O1CN01iKlQmx1TELUnlcwXU_!!6000000002350-2-tps-195-48.png",
"renzhengiconUrl": "https://gw.alicdn.com/imgextra/i2/O1CN018Uwwvn24tF1X9eUV0_!!6000000007448-2-tps-228-48.png"
},
"props": [
{
"name": "品牌",
"value": "MIUI/小米"
},
{
"name": "型号",
"value": "喷墨打印一体机"
},
{
"name": "功能状态",
"value": "功能完好无维修"
}
],
"prop_imgs": {
"prop_img": []
},
"props_img": [],
"data_from": "alex",
"format_check": "ok",
"sales": 0,
"shop_item": [],
"relate_items": []
},