一、接口概述
闲鱼商品详情API接口（如xianyu.item.get或类似接口）是闲鱼开放平台提供的开发者工具，用于获取二手商品的详细信息。通过该接口，开发者可以获取商品标题、价格、描述、图片、卖家信息、交易状态等核心数据，支持电商比价、数据分析、自动化交易等场景。
核心功能：
- 商品基础信息：标题、分类、品牌、型号等。
- 价格与交易状态：当前售价、原价、库存状态、交易方式（如包邮/自提）。
- 图片与视频：主图、详情图、视频链接（如有）。
- 卖家信息：昵称、信用等级、历史成交记录（部分字段可能需额外权限）。
- 商品描述：文本内容（可能含HTML标签）、关键属性（如成色、保修期）。
- 物流与售后：运费模板、退换货政策（需结合闲鱼规则）。
调用方式：
-
请求方法 ：通常为
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 |
| | } |
| | } |
| | } |
关键字段说明：
- 商品状态 ：
status：在售、已售出、下架等。view_count和wish_count：反映商品热度。
- 价格与优惠 ：
original_price：原价（若商品有折扣）。- 促销信息可能通过额外字段返回（如
promotions数组）。
- 卖家信用 ：
credit_level：极好、优秀、良好等。good_rate：好评率（百分比）。
- 图文详情 ：
description可能包含HTML标签，需解析后展示。- 图片URL通常为闲鱼CDN地址，需处理防盗链（如添加Referer头）。