闲鱼商品详情 API 接口返回的 JSON 数据示例如下（基于第三方服务商接口规范）：
# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# API供应商demo url=o0b.cn/ibrad
# 请求示例 url 默认请求参数已经做URL编码
url = "https://#/goodfish/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=750828541223"
headers = {
"Accept-Encoding": "gzip",
"Connection": "close"
}
if __name__ == "__main__":
r = requests.get(url, headers=headers)
json_obj = r.json()
print(json_obj)
关键字段说明：
- 状态信息：
-
code: 响应状态码（200 表示成功，400/500 等为错误代码）。 -
message: 状态描述（如 "调用成功" 或具体错误原因）。 -
商品基础信息：
-
id: 商品唯一标识符。 -
title: 商品标题。 -
price: 当前售价（单位：元）。 -
original_price: 原价（若存在折扣）。 -
imageUrl: 主图 URL，支持多图时为数组格式。 -
description: 商品描述（可能包含 HTML 标签）。 -
location: 商品所在地。 -
sales: 已售数量。 -
status: 商品状态（在售、已售出、下架）。 -
category: 商品分类路径。 -
publish_time: 发布时间（格式：YYYY-MM-DD HH:MM:SS）。 -
卖家信息：
-
nick: 卖家昵称。 -
credit_level: 信用等级（极好、优秀、良好等）。 -
good_rate: 好评率（百分比）。
接口调用注意事项：
- 身份验证：
-
需提供
app_key（应用密钥）和sign（签名）。 -
签名生成规则：将请求参数按字典序排序，拼接成字符串后使用 MD5 或 HMAC-SHA256 算法加密。
-
参数要求：
-
必选参数：
num_iid（商品 ID）、timestamp（请求时间戳）。 -
可选参数：
cache（是否使用缓存）、lang（返回语言）等。
示例代码（Python）：
import requests
import hashlib
def generate_sign(params, app_secret):
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = app_secret + ''.join([f"{k}{v}" for k, v in sorted_params])
return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()
def get_item_details(app_key, app_secret, item_id):
url = "https://api-gw.onebound.cn/goodfish/item_get/"
timestamp = "2025-10-13 14:50:00"
params = {
"key": app_key,
"num_iid": item_id,
"timestamp": timestamp,
"version": "1.0",
"cache": "no",
"result_type": "json",
"lang": "zh-CN"
}
params["sign"] = generate_sign(params, app_secret)
response = requests.get(url, params=params)
return response.json()
# 示例调用
# API供应商demo url=o0b.cn/ibrad
app_key = "YOUR_APP_KEY"
app_secret = "YOUR_APP_SECRET"
item_id = "123456789"
result = get_item_details(app_key, app_secret, item_id)
print(result)
数据来源说明：
- 上述示例基于第三方数据服务商 的接口规范，实际字段可能因接口版本或平台策略调整而变化。
- 若需获取官方接口，需通过闲鱼开放平台（open.taobao.com）申请权限并遵守其开发者协议。需要处理分页逻辑（示例中未展示分页参数）建议包含错误处理机制.
.通过合理使用闲鱼item_get接口，开发者可高效获取闲鱼商品数据，结合业务场景构建智能电商应用。定期关注接口更新（如字段新增、权限调整），确保服务稳定性。
建议在使用前查阅最新接口文档，并进行充分的测试以确保数据准确性和稳定性。
