闲鱼商品详情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头)。
相关推荐
数智顾问4 分钟前
【73页PPT】美的简单高效的管理逻辑(附下载方式)
大数据·人工智能·产品运营
love530love6 分钟前
【保姆级教程】阿里 Wan2.1-T2V-14B 模型本地部署全流程:从环境配置到视频生成(附避坑指南)
人工智能·windows·python·开源·大模型·github·音视频
和科比合砍81分20 分钟前
ES模块(ESM)、CommonJS(CJS)和UMD三种格式
大数据·elasticsearch·搜索引擎
He19550137 分钟前
Go初级之十:错误处理与程序健壮性
开发语言·python·golang
Y4090011 小时前
数据库基础知识——聚合函数、分组查询
android·数据库
和鲸社区1 小时前
《斯坦福CS336》作业1开源,从0手搓大模型|代码复现+免环境配置
人工智能·python·深度学习·计算机视觉·语言模型·自然语言处理·nlp
瓦哥架构实战1 小时前
从 Prompt 到 Context:LLM OS 时代的核心工程范式演进
大数据
豌豆花下猫2 小时前
Python 潮流周刊#118:Python 异步为何不够流行?(摘要)
后端·python·ai
weixin_lynhgworld2 小时前
盲盒抽卡机小程序系统开发:以技术创新驱动娱乐体验升级
大数据·盲盒·抽谷机
THMAIL2 小时前
深度学习从入门到精通 - LSTM与GRU深度剖析:破解长序列记忆遗忘困境
人工智能·python·深度学习·算法·机器学习·逻辑回归·lstm