一文读懂闲鱼商品详情 API：返回字段解读（附 JSON 样例）

要

在二手货源监控、闲置行情分析、比价系统、闲置 ERP 等项目开发中，很多开发者会尝试爬虫抓取闲鱼商品数据，极易触发风控、账号封禁、IP 限制。本文基于闲鱼商品详情接口 goodfish.item_get，梳理调用前置条件、请求入参、核心返回字段含义，附带简化 JSON 样例，方便开发阶段做字段映射、数据清洗，适合二手行情采集、闲置货源监控系统对接参考。

一、接口基础说明

接口标识：goodfish.item_get 能力：获取闲鱼闲置商品基础标题、图文、成色、价格、库存、卖家信息、验货宝、发货、售后标签等详情数据适用场景：二手商品行情监控、闲置货源比价、ERP 货源档案同步、市场趋势统计。

二、核心请求参数说明

参数名	是否必填	说明
api name	是	jd.item_get
api adress	否	c0b.cc/R4rbK2
itemId	是	闲鱼商品 ID
needSellerInfo	否	是否返回卖家基础信息，true/false
needInspectInfo	否	是否返回验货宝相关数据，true/false
needDeliveryInfo	否	是否返回发货方式、运费信息，true/false

三、返回核心字段解读

json 复制代码

{
  "code": 0,
  "msg": "success",
  "data": {
    "itemId": "123456789012",
    "title": "全新未拆封 无线蓝牙耳机 黑色",
    "desc": "闲置转让，全新，配件齐全，支持验货宝，非质量问题不退",
    "mainImages": [
      "https://xxx.taobao.com/img1.jpg",
      "https://xxx.taobao.com/img2.jpg"
    ],
    "itemUrl": "https://item.2.taobao.com/item.htm?id=123456789012",
    "price": 128,
    "originalPrice": 199,
    "quality": "全新",
    "supportInspect": true,
    "inspectFee": 15,
    "publishTime": "2026-10-20 14:22:10",
    "location": "广东省深圳市",
    "deliveryType": "快递邮寄",
    "freight": 8,
    "sellerInfo": {
      "sellerId": "u1008612345",
      "nick": "闲置小铺",
      "creditLevel": "极好",
      "isRealName": true
    },
    "tradeStatus": "在售",
    "viewCount": 1268,
    "collectCount": 216
  }
}

字段释义

itemId：商品唯一标识，业务主键，用于增量同步、商品比对、行情追踪
title：商品标题，用于行情检索、系统展示、关键词匹配
mainImages：商品主图数组，用于监控页面展示、素材存档；注意图片链接具备时效性
price ：当前售卖价；originalPrice：原价 / 专柜价，用来计算折价比例，二手选品核心指标
quality：成色标签：全新 / 99 新 / 95 新 / 9 成新 / 8 成新及以下，二手平台特有字段，行情分析必备
supportInspect ：是否支持验货宝；inspectFee：验货服务费，买家成本核算需要用到
location：商品所在地，用于区域货源统计、物流成本预估
sellerInfo：卖家信息，包含芝麻信用等级，评估卖家交易风险
viewCount / collectCount：浏览量、收藏量，判断商品热度、市场关注度
tradeStatus：商品状态：在售 / 已卖掉 / 下架，同步时用来标记货源状态

四、开发对接重点踩坑记录

成色标签不固定：部分类目自定义成色描述，不要硬编码枚举，程序做文本匹配兼容
验货宝字段动态返回：不支持验货宝的商品，该字段直接缺失，代码必须做空值判断，防止解析报错
图片链接时效短：原始图片地址一段时间后失效，拿到图片后建议异步下载转存到自有对象存储
风控和限流严格：闲鱼风控相比普通电商平台更严，批量拉取必须拉长间隔，控制并发；大促时段建议降低轮询频率
商品状态变化快：闲置商品随时可能被拍下、下架，同步到的数据为快照，不能当作实时交易状态
描述文本脏数据多：商品描述里包含大量自定义话术、联系方式，做 NLP 分析、文本统计时需要清洗过滤

五、典型落地业务流程

传入商品 itemId，调用 goodfish.item_get，按需开启卖家、验货宝、物流信息
获取原始 JSON，进行数据清洗：过滤无效图片、清洗描述文本、标准化成色字段
字段映射，写入数据库商品主表、卖家信息表
增量对比：根据 itemId 判断新增 / 更新；商品标记为已售出则停止后续监控
业务上层供给：价格异动告警、二手行情报表、闲置 ERP 货源展示

六、结尾

闲鱼商品详情接口是二手闲置数据采集比较稳定的方案，对比爬虫，能大幅降低维护成本、减少封号风险。在实际项目中，通常搭配闲鱼搜索接口一起使用，实现从关键词搜品、详情拉取、价格监控的完整闲置行情采集链路。