闲鱼商品详情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头)。
相关推荐
Python×CATIA工业智造2 小时前
Frida RPC高级应用:动态模拟执行Android so文件实战指南
开发语言·python·pycharm
onceco2 小时前
领域LLM九讲——第5讲 为什么选择OpenManus而不是QwenAgent(附LLM免费api邀请码)
人工智能·python·深度学习·语言模型·自然语言处理·自动化
狐凄3 小时前
Python实例题:基于 Python 的简单聊天机器人
开发语言·python
悦悦子a啊4 小时前
Python之--基本知识
开发语言·前端·python
雨白5 小时前
Jetpack系列(三):Room数据库——从增删改查到数据库平滑升级
android·android jetpack
笑稀了的野生俊6 小时前
在服务器中下载 HuggingFace 模型:终极指南
linux·服务器·python·bash·gpu算力
Naiva6 小时前
【小技巧】Python+PyCharm IDE 配置解释器出错,环境配置不完整或不兼容。(小智AI、MCP、聚合数据、实时新闻查询、NBA赛事查询)
ide·python·pycharm
路来了6 小时前
Python小工具之PDF合并
开发语言·windows·python
蓝婷儿6 小时前
Python 机器学习核心入门与实战进阶 Day 3 - 决策树 & 随机森林模型实战
人工智能·python·机器学习
AntBlack7 小时前
拖了五个月 ,不当韭菜体验版算是正式发布了
前端·后端·python