闲鱼商品详情API接口概述及JSON数据参考

一、接口概述

闲鱼商品详情API接口（如xianyu.item.get或类似接口）是闲鱼开放平台提供的开发者工具，用于获取二手商品的详细信息。通过该接口，开发者可以获取商品标题、价格、描述、图片、卖家信息、交易状态等核心数据，支持电商比价、数据分析、自动化交易等场景。

核心功能：

1. 商品基础信息：标题、分类、品牌、型号等。
2. 价格与交易状态：当前售价、原价、库存状态、交易方式（如包邮/自提）。
3. 图片与视频：主图、详情图、视频链接（如有）。
4. 卖家信息：昵称、信用等级、历史成交记录（部分字段可能需额外权限）。
5. 商品描述：文本内容（可能含HTML标签）、关键属性（如成色、保修期）。
6. 物流与售后：运费模板、退换货政策（需结合闲鱼规则）。

调用方式：

• 请求方法：通常为GET或POST，需携带AppKey、Timestamp、Sign等参数进行身份验证。
• 参数示例：

  	{
  	"item_id": "1234567890", // 商品唯一ID
  	"fields": "title,price,images,description,seller_nick" // 指定返回字段
  	}

• 签名机制：基于AppSecret对参数进行加密（如MD5或HMAC-SHA256），确保请求合法性。

二、JSON数据参考

以下为模拟的闲鱼商品详情API返回的JSON数据结构（实际字段可能因接口版本调整）：

	{
	"code": 200,
	"message": "success",
	"data": {
	"item": {
	"item_id": "1234567890",
	"title": "iPhone 15 Pro Max 256G 银色 99新",
	"category": "手机/数码/手机",
	"brand": "Apple",
	"model": "iPhone 15 Pro Max",
	"price": 7800.00,
	"original_price": 9999.00,
	"condition": "99新",
	"warranty": "剩余3个月官方保修",
	"images": [
	"https://img.xianyu.com/item/1234567890_1.jpg",
	"https://img.xianyu.com/item/1234567890_2.jpg"
	],
	"description": "<p>自用iPhone 15 Pro Max，国行正品，无拆无修，成色极佳，带原装充电器和保护壳。</p><p>支持验货宝，顺丰包邮。</p>",
	"seller": {
	"nick": "数码小铺",
	"credit_level": "极好",
	"good_rate": "98%",
	"seller_type": "个人卖家"
	},
	"trade_info": {
	"freight": "包邮",
	"delivery_area": "全国",
	"return_policy": "7天无理由退货（需保持商品原样）"
	},
	"status": "在售",
	"published_at": "2025-04-25T14:30:00Z",
	"view_count": 1287,
	"wish_count": 45
	}
	}
	}

关键字段说明：

1. 商品状态：
   • status：在售、已售出、下架等。
   • view_count和wish_count：反映商品热度。
2. 价格与优惠：
   • original_price：原价（若商品有折扣）。
   • 促销信息可能通过额外字段返回（如promotions数组）。
3. 卖家信用：
   • credit_level：极好、优秀、良好等。
   • good_rate：好评率（百分比）。
4. 图文详情：
   • description可能包含HTML标签，需解析后展示。
   • 图片URL通常为闲鱼CDN地址，需处理防盗链（如添加Referer头）。