一、接口概述
闲鱼商品详情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头)。