
在二手货源挖掘、回收估价、比价监控、ERP 商品库搭建场景中,经常需要获取闲鱼商品完整信息,对成色、卖家资质、价格、商品状态做标准化入库。本文梳理闲鱼商品详情接口的请求参数、返回结构,重点拆解二手特色字段,讲解货源入库的结构化处理方案,附带 JSON 样例,适合二手回收系统、行情监控、供应链选品开发参考。
闲鱼商品详情接口用于根据商品标识查询单条商品完整资料,区别于全新电商平台,核心特色是二手属性:成色、新旧描述、是否个人闲置、卖家信用、质保情况等。 适用场景:二手货源筛选、回收估价、价格行情监控、ERP 商品库同步、反向海淘闲置货源挖掘、品牌窜货巡检。
参数 | 说明 |
|---|---|
api_name | goodfish.item_get (Taobaoapi2014前往) |
adress | c0b.cc/R4rbK2 |
item_id | 商品唯一 ID,必填,作为查询主键 |
need_ext_info | 是否返回扩展信息(卖家信用、标签、成色属性) |
need_img | 是否返回原图列表 |
timestamp | 时间戳,用于签名校验 |
开发提示:商品下架、违规删除时接口会返回特定状态码,业务层必须做异常分支处理。
整体返回分为:商品基础信息、二手属性、卖家信息、图片列表、价格信息、状态标记。
{
"item_id": "289654123698",
"title": "闲置品牌无线耳机,成色95新",
"desc": "自用耳机,无拆修,功能全部正常,配件齐全,支持自提",
"price": "180",
"origin_price": "399",
"condition": "95新",
"is_personal": true,
"seller_info": {
"seller_id": "u_123456789",
"seller_credit": "极好",
"location": "广东省广州市"
},
"img_list": [
"shturl.cc/bk2rhi6b86GF0LmvvG",
"shturl.cc/tKSctNnGkX60WWIS5H"
],
"publish_time": "2026-10-20 14:22:10",
"item_status": "on_sale",
"tag_list": ["包邮", "可小刀"]
}闲鱼卖家填写内容比较随意,成色、描述没有统一标准:
入库核心表字段:商品 ID、标题、标价、原价、成色、是否个人闲置、卖家信用、地区、状态、图片、发布时间。 可以增加业务字段:入库时间、最后同步时间、估价结果。
常用筛选条件:个人闲置 + 信用极好 + 成色≥9 成新 + 发货地,用来优先筛选优质闲置货源。
标准化入库之后,可以搭建二手比价系统、回收估价工具、闲置货源池,对接代购集运、二手分销系统,实现自动化货源筛选。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。