闲鱼商品详情API接口返回的JSON数据示例

闲鱼商品详情 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)

关键字段说明：

1. 状态信息 ：

• code: 响应状态码（200 表示成功，400/500 等为错误代码）。
• message: 状态描述（如 "调用成功" 或具体错误原因）。
• 商品基础信息 ：
• id: 商品唯一标识符。
• title: 商品标题。
• price: 当前售价（单位：元）。
• original_price: 原价（若存在折扣）。
• imageUrl: 主图 URL，支持多图时为数组格式。
• description: 商品描述（可能包含 HTML 标签）。
• location: 商品所在地。
• sales: 已售数量。
• status: 商品状态（在售、已售出、下架）。
• view_count: 浏览量。
• wish_count: 想要数。
• category: 商品分类路径。
• publish_time: 发布时间（格式：YYYY-MM-DD HH:MM:SS）。
• 卖家信息 ：
• nick: 卖家昵称。
• credit_level: 信用等级（极好、优秀、良好等）。
• good_rate: 好评率（百分比）。
• seller_id: 加密后的卖家 ID（需通过特定算法解密）。

接口调用注意事项：

1. 身份验证 ：

• 需提供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()

# 示例调用
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)

数据来源说明：

• 上述示例基于第三方数据服务商的接口规范，实际字段可能因接口版本或平台策略调整而变化。
• 若需获取官方接口，需通过闲鱼开放平台（[https://open.taobao.com]）申请权限并遵守其开发者协议。需要处理分页逻辑（示例中未展示分页参数）建议包含错误处理机制.

.通过合理使用闲鱼item_get接口，开发者可高效获取闲鱼商品数据，结合业务场景构建智能电商应用。定期关注接口更新（如字段新增、权限调整），确保服务稳定性。

建议在使用前查阅最新接口文档，并进行充分的测试以确保数据准确性和稳定性。

审核编辑 黄宇