一、摘要
闲鱼商品详情API是阿里巴巴旗下二手交易平台闲鱼提供的开发者接口，主要用于通过商品ID获取商品的详细信息。该接口支持多种开发语言调用，返回JSON格式数据，包含商品基本信息、卖家信息、图片视频等内容。
二、接口概述
1. 必填参数：
app_key：开发者在闲鱼开放平台申请的应用密钥，用于身份验证。num_iid：闲鱼商品的唯一标识符，从商品 URL 中获取。timestamp：请求时间戳，格式为YYYY-MM-DD HH:MM:SS。sign：根据请求参数和app_secret生成的签名，确保请求安全性。
2. 可选参数：
cache：是否使用缓存，默认no。lang：返回语言，默认zh-CN（简体中文）。version：API 版本，如1.0。
三、Python 请求示例
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function import requests
# 配置参数 API_ url=o0b.cn/ibrad， wechat id: TaoxiJd-api 复制链接获取测试 "
app_key = "YOUR_APP_KEY" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/item_get/?key=<您自己的apiKey>&num_iid=123456" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)四、返回数据结构
json{ "code": 200, "message": "调用成功",
"data": { "id": "123456789",
"title": "商品标题",
"price": "当前售价",
"original_price": "原价",
"imageUrl": "主图URL",
"description": "商品描述",
"location": "商品所在地",
"sales": "已售数量",
"status": "商品状态",
"view_count": "浏览量",
"wish_count": "想要数",
"category": "商品分类路径",
"publish_time": "发布时间",
"nick": "卖家昵称",
"credit_level": "信用等级",
"good_rate": "好评率",
"seller_id": "加密后的卖家ID",
"promotions": "促销活动数组"
}}五、总结
闲鱼商品详情API为开发者提供了标准化的商品数据获取渠道，支持多种应用场景开发。在实际使用中，开发者需要关注官方文档更新，确保接口调用的准确性和合规性。同时需要注意API调用频率限制，合理处理错误响应，保证应用的稳定运行。
