闲鱼商品详情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头)。
相关推荐
en-route7 分钟前
使用 Flask 构建 Web 应用:静态页面与动态 API 访问
前端·python·flask
ZeroNews内网穿透9 分钟前
新版发布!“零讯”微信小程序版本更新
运维·服务器·网络·python·安全·微信小程序·小程序
molong9319 分钟前
Android 应用配置跳转微信小程序
android·微信小程序·小程序
2501_9151063219 分钟前
iOS 可分发是已经上架了吗?深入解析应用分发状态、ipa 文件上传、TestFlight 测试与 App Store 审核流程
android·ios·小程序·https·uni-app·iphone·webview
hrrrrb1 小时前
【Python】文件处理(二)
开发语言·python
万粉变现经纪人4 小时前
如何解决 pip install 安装报错 ModuleNotFoundError: No module named ‘tokenizers’ 问题
python·selenium·测试工具·scrapy·beautifulsoup·fastapi·pip
编程武士6 小时前
从50ms到30ms:YOLOv10部署中图像预处理的性能优化实践
人工智能·python·yolo·性能优化
我的xiaodoujiao6 小时前
Windows系统Web UI自动化测试学习系列2--环境搭建--Python-PyCharm-Selenium
开发语言·python·测试工具
计算机编程小央姐6 小时前
【Spark+Hive+hadoop】基于spark+hadoop基于大数据的人口普查收入数据分析与可视化系统
大数据·hadoop·数据挖掘·数据分析·spark·课程设计
鲲志说7 小时前
数据洪流时代,如何挑选一款面向未来的时序数据库?IoTDB 的答案
大数据·数据库·apache·时序数据库·iotdb