闲鱼商品列表API接口商品详情API接口请求示例（含一份真实响应数据示例）
很多做无货源、二手选品、货源比价的团队，习惯性地把闲鱼当成"另一个京东"，结果接上接口就懵了——SKU 是空的、属性列表是空的、价格是字符串。
这不是接口没做好，是因为两个平台的商品模型本来就不同：
维度 | 京东 | 闲鱼 |
商品模型 | 一物多规格（SKU） | 一物一价，无 SKU |
| 通常几十条 | 空数组（正常） |
| 完整的尺码/颜色字典 | 空数组（正常） |
价格类型 | 数字 | 字符串 |
卖家主体 | 店铺（ | 个人（信用分/实名/常出没城市） |
热度指标 |
|
|
主图地址 | 协议相对 | 硬编码 |
时效性 | 长期在售 | 随时被卖掉，价格随时改 |
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| 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 | market.m.taobao.com/app/idleFis… | 商品链接 | |
| 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 | img.alicdn.com/bao/uploade… | 商品图片 | |
| 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 | [] | 商品视频 |
请求示例
商品详情item_get响应示例
bash代码解读复制代码 "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": [] },
作者：跨境代采系统API
链接：https://juejin.cn/spost/7695604296683700234
来源：稀土掘金
著作权归作者所有。商业转载请联系作者获得授权，非商业转载请注明出处。
