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

一、接口概述

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

核心功能

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

调用方式

  • 请求方法 :通常为GETPOST,需携带AppKeyTimestampSign等参数进行身份验证。

  • 参数示例

    |---|--------------------------------------------------------------------|
    | | { |
    | | "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_countwish_count:反映商品热度。
  2. 价格与优惠
    • original_price:原价(若商品有折扣)。
    • 促销信息可能通过额外字段返回(如promotions数组)。
  3. 卖家信用
    • credit_level:极好、优秀、良好等。
    • good_rate:好评率(百分比)。
  4. 图文详情
    • description可能包含HTML标签,需解析后展示。
    • 图片URL通常为闲鱼CDN地址,需处理防盗链(如添加Referer头)。
相关推荐
EasyGBS2 分钟前
哪些因素会影响远程视频监控的质量?浅述EasyCVR视频智能诊断技术
大数据·网络·人工智能·音视频
hvinsion3 分钟前
【开源工具】Python打造智能IP监控系统:邮件告警+可视化界面+配置持久化
python·tcp/ip·开源·ip监控
tangweiguo0305198735 分钟前
Android Kotlin 依赖注入全解:Koin appModule 配置与多 ViewModel 数据共享实战指南
android·kotlin
西楚曹长卿37 分钟前
RN 获取视频封面,获取视频第一帧
android·react native·音视频·react
Humbunklung37 分钟前
Sigmoid函数简介及其Python实现
开发语言·python·深度学习·机器学习
NON-JUDGMENTAL1 小时前
Hadoop 集群基础指令指南
大数据·hadoop·分布式
建群新人小猿1 小时前
CRMEB-PRO系统定时任务扩展开发指南
android·java·开发语言·前端
麦麦大数据1 小时前
vue+django农产品价格预测和推荐可视化系统[带知识图谱]
vue.js·python·django·知识图谱·推荐算法·价格预测·农业大数据
liwulin05062 小时前
【JAVAFX】实现屏幕指定区域截图,带尺寸显示
服务器·前端·python
百流2 小时前
ES使用之查询方式
android·大数据·elasticsearch