闲鱼商品详情API接口
闲鱼(阿里巴巴旗下二手交易平台)的商品详情API接口通常不公开对外提供,但可以通过以下几种方式获取商品详情数据:
1. 官方开放API
闲鱼提供了一些官方API接口,但需要申请权限:
-
主要接口包括:
idle.item.get
- 获取单个闲置商品详情idle.items.search
- 搜索闲置商品
示例请求参数
json
json
{
"method": "idle.item.get",
"app_key": "你的应用key",
"target_app_key": "闲鱼appkey",
"sign_method": "md5",
"sign": "签名",
"timestamp": "2023-01-01 12:00:00",
"format": "json",
"v": "2.0",
"item_id": "商品ID"
}
示例响应数据
json
json
{
"idle_item_get_response": {
"item": {
"item_id": "123456789",
"title": "二手iPhone 12 128G 国行",
"price": "3999.00",
"original_price": "6299.00",
"desc": "自用iPhone 12,无拆无修,成色95新",
"images": [
"https://img.alicdn.com/imgextra/i1/123456789/O1CN01abc123_123456789.jpg",
"https://img.alicdn.com/imgextra/i2/123456789/O1CN01def456_123456789.jpg"
],
"category_id": "50012345",
"category_name": "手机",
"condition": "95成新",
"user": {
"user_id": "987654321",
"nick": "张三的二手店",
"avatar": "https://img.alicdn.com/tps/i1/TB1abcXYZ.jpg"
},
"location": "北京市海淀区",
"postage": "0.00",
"status": "1", // 1-在售 2-已售出
"create_time": "2023-01-01 10:00:00",
"refresh_time": "2023-01-05 14:30:00"
}
}
}
2. 网页爬取方式(非官方)
⚠️ 注意:这种方式可能违反闲鱼的使用条款,仅供学习参考
通过分析闲鱼网页版或移动端的请求,可以找到商品详情的API接口:
移动端API示例
bash
GET https://api.闲鱼.com/item/detail?itemId=商品ID&detailVersion=3.0
响应数据结构
json
json
{
"data": {
"item": {
"id": "123456789",
"title": "商品标题",
"price": "价格",
"originalPrice": "原价",
"description": "商品描述",
"images": ["图片URL数组"],
"video": "视频URL(如果有)",
"seller": {
"userId": "卖家ID",
"nick": "卖家昵称",
"avatar": "头像URL",
"fansCount": 粉丝数,
"sellerLevel": "卖家等级"
},
"location": "所在地区",
"postage": "运费",
"status": 1, // 状态
"createTime": 创建时间戳,
"refreshTime": 刷新时间戳,
"viewCount": 浏览次数,
"wantCount": 想要人数,
"commentCount": 评论数
},
"similarItems": [相似商品数组],
"shopInfo": {
"shopId": "店铺ID",
"shopName": "店铺名称",
"shopIcon": "店铺图标",
"itemCount": 商品数量
}
},
"success": true,
"code": 200
}
3. 使用第三方数据服务
一些第三方数据服务提供商可能封装了闲鱼API,例如:
- 某些数据采集平台
- 电商数据服务公司
注意事项
- 使用官方API需要申请权限并遵守闲鱼开放平台规则
- 直接爬取闲鱼数据可能违反其服务条款,存在法律风险
- 高频请求可能会触发反爬机制
- 返回的数据结构可能会随闲鱼版本更新而变化
如需稳定可靠的闲鱼商品数据,建议通过官方渠道申请API权限。