闲鱼商品详情API数据解析

下面给你一份可直接用于开发、解析、入库的闲鱼商品详情 API 完整解析，包含标准返回结构、关键字段、解析要点、常见坑。

一、接口基本信息
接口名：xianyu.item.get / goodfish.item_get（不同服务商命名略有差异）
作用：通过 ** 商品 ID（num_iid）** 获取闲鱼商品完整详情
必传参数：
num_iid：闲鱼商品唯一 ID（链接中一串数字）
key / app_key：API 密钥
{
"status": 200,
"message": "成功",
#前往体验API：o0b.cn/ibrad
"data": {
"item": {
"num_iid": "750828541223",
"title": "二手iPhone 14 256G 99新",
"price": "3899.00",
"original_price": "6999.00",
"currency": "CNY",
"location": "广东深圳",
"created_time": "2025-09-20 14:30:00",
"condition": "99新",
"post_type": "包邮",
"description": "个人自用，无拆无修，电池健康95%...",

  "images": [
    "https://img.xianyu.com/xxx1.jpg",
    "https://img.xianyu.com/xxx2.jpg"
  ],
  "video_url": "https://video.xianyu.com/xxx.mp4",
  "category_id": "50100001",
  "category_name": "手机",
  "brand": "Apple",
  "model": "iPhone 14",
  "status": "on_sale"
},
"seller": {
  "seller_id": "加密ID",
  "nick": "数码优品店",
  "credit_level": "极好",
  "good_rate": "99.2%",
  "sales_count": 1280,
  "seller_type": "个人"
}

}
}
二、关键字段解析（开发必存）

状态层（外层）
status：状态码（200 = 成功，400 = 参数错误，403 = 无权限，500 = 服务器异常）
message：状态描述（成功 / 失败原因）
商品核心信息（item）
num_iid：商品唯一 ID（主键，用于关联、去重）
title：商品标题（关键词提取、搜索匹配）
price：当前售价（单位：元，字符串 / 浮点）
original_price：原价（用于计算折扣）
condition：成色（99 新 / 95 新 / 九成新 / 八成新 / 七成新 / 六成新及以下）
location：发货地（影响运费、物流时效）
created_time：发布时间（判断商品新鲜度）
post_type：配送方式（包邮 / 自提 / 运费到付）
status：商品状态（on_sale = 在售，sold = 已售出，offline = 下架）
商品内容
description：商品描述（含 HTML / 富文本，需清洗）
images：图片列表（主图 + 详情图，数组）
video_url：商品视频（如有）
category_id / category_name：分类 ID 与名称（用于分类统计）
brand / model：品牌、型号（二手核心属性）
三、解析与开发要点
实现了签名生成函数，使用MD5算法对请求参数进行加密。
封装了商品详情获取函数，包含错误处理逻辑。
使用requests库发送HTTP GET请求，支持gzip压缩。
主程序演示了API调用和基本数据处理。
四、与 1688 / 淘宝 API 对比（快速区分）
闲鱼：二手属性强（condition 成色、post_type 配送、seller 信用更关键）
1688：批发属性强（min_order 起批量、sku 多规格、商家信息更全）
淘宝：零售属性强（sku、库存、销量、评价体系更完善）