首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >一文读懂闲鱼商品详情 API:返回字段拆解、二手货源入库方案(附 JSON 样例)

一文读懂闲鱼商品详情 API:返回字段拆解、二手货源入库方案(附 JSON 样例)

原创
作者头像
用户1597063760
发布于 2026-11-17 14:23:00
发布于 2026-11-17 14:23:00
190
举报
文章被收录于专栏:经验经验

摘要

在二手货源挖掘、回收估价、比价监控、ERP 商品库搭建场景中,经常需要获取闲鱼商品完整信息,对成色、卖家资质、价格、商品状态做标准化入库。本文梳理闲鱼商品详情接口的请求参数、返回结构,重点拆解二手特色字段,讲解货源入库的结构化处理方案,附带 JSON 样例,适合二手回收系统、行情监控、供应链选品开发参考。

一、接口简介

闲鱼商品详情接口用于根据商品标识查询单条商品完整资料,区别于全新电商平台,核心特色是二手属性:成色、新旧描述、是否个人闲置、卖家信用、质保情况等。 适用场景:二手货源筛选、回收估价、价格行情监控、ERP 商品库同步、反向海淘闲置货源挖掘、品牌窜货巡检。

二、核心请求参数

参数

说明

api_name

goodfish.item_get (Taobaoapi2014前往)

adress

c0b.cc/R4rbK2

item_id

商品唯一 ID,必填,作为查询主键

need_ext_info

是否返回扩展信息(卖家信用、标签、成色属性)

need_img

是否返回原图列表

timestamp

时间戳,用于签名校验

开发提示:商品下架、违规删除时接口会返回特定状态码,业务层必须做异常分支处理。

三、返回结构与关键字段拆解

整体返回分为:商品基础信息、二手属性、卖家信息、图片列表、价格信息、状态标记。

  • item_id:商品编号
  • title:商品标题
  • desc:商品详情描述
  • price:标价
  • origin_price:原价(全新参考价)
  • condition:成色(全新 / 99 新 / 95 新 / 9 成新 / 8 成新及以下)
  • is_personal:是否个人闲置(区分商家货)
  • seller_id:卖家 ID
  • seller_credit:卖家信用等级(极好 / 良好 / 一般 / 较差)
  • location:发货地
  • img_list:图片数组
  • publish_time:发布时间
  • item_status:商品状态(在售 / 已卖掉 / 下架)
  • tag_list:商品标签,如自提、包邮、可小刀

四、JSON 返回样例

代码语言:javascript
复制
{
  "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": ["包邮", "可小刀"]
}

五、二手货源入库落地方案

1. 字段标准化清洗

闲鱼卖家填写内容比较随意,成色、描述没有统一标准:

  • 把接口返回的condition映射成系统内部枚举值,方便筛选统计;
  • 标题、描述做文本清洗,去除表情、特殊符号;
  • 价格转为数字类型,便于比价、排序。

2. 入库数据模型设计

入库核心表字段:商品 ID、标题、标价、原价、成色、是否个人闲置、卖家信用、地区、状态、图片、发布时间。 可以增加业务字段:入库时间、最后同步时间、估价结果。

3. 增量同步策略

  • 定时轮询:对重点关注商品定时拉取详情,检测状态变更(在售→已售出 / 下架);
  • 变更告警:状态、价格发生变动时,推送消息给运营 / 采购;
  • 过滤策略:入库时可配置规则,自动过滤信用差、成色过低、违规品类商品。

4. 业务筛选组合

常用筛选条件:个人闲置 + 信用极好 + 成色≥9 成新 + 发货地,用来优先筛选优质闲置货源。

六、开发踩坑与注意事项

  1. 商品生命周期短:二手商品出单快,很多商品短时间内就会下架,需要做好状态判断;
  2. 图片资源时效:图片链接存在有效期,入库后建议本地或对象存储转存;
  3. 内容不规范:卖家自定义描述多,不能完全依赖接口标签,复杂估价场景需要搭配文本识别;
  4. 访问频率管控:短时间大量查询容易触发限流,推荐使用队列异步消费,控制并发;
  5. 类目混杂:闲鱼闲置品类繁杂,需要在业务层做类目归类,方便后续货源管理。

七、业务延伸

标准化入库之后,可以搭建二手比价系统、回收估价工具、闲置货源池,对接代购集运、二手分销系统,实现自动化货源筛选。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 摘要
  • 一、接口简介
  • 二、核心请求参数
  • 三、返回结构与关键字段拆解
  • 四、JSON 返回样例
  • 五、二手货源入库落地方案
    • 1. 字段标准化清洗
    • 2. 入库数据模型设计
    • 3. 增量同步策略
    • 4. 业务筛选组合
  • 六、开发踩坑与注意事项
  • 七、业务延伸
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档