闲鱼商品详情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头)。
相关推荐
熊猫在哪6 分钟前
野火鲁班猫(arrch64架构debian)从零实现用MobileFaceNet算法进行实时人脸识别(一)conda环境搭建
linux·人工智能·python·嵌入式硬件·神经网络·机器学习·边缘计算
满怀101512 分钟前
【Python中的Socket套接字详解】网络通信的核心基石
开发语言·网络·python·网络编程·socket
看到我,请让我去学习18 分钟前
LInux—shell编程
android·linux·chrome
胡尔摩斯.26 分钟前
ElasticSearch操作
大数据·elasticsearch·jenkins
pk_xz12345629 分钟前
Python程序实现了一个完整的车辆信息查询系统
开发语言·python·opencv
Stuomasi_xiaoxin38 分钟前
FFmpeg 超级详细安装与配置教程(Windows 系统)
python·深度学习·ai·ffmpeg
z人间防沉迷k1 小时前
高效查询:位图、B+树
开发语言·数据结构·笔记·python·算法
.小墨迹2 小时前
Python学习——执行python时,键盘按下ctrl+c,退出程序
linux·开发语言·python·学习·自动驾驶
蓝婷儿2 小时前
6个月Python学习计划 Day 1
开发语言·python·学习
chicpopoo2 小时前
Python打卡DAY33
开发语言·python