閑魚商品詳情 API 接口返回的 JSON 數據示例如下（基于第三方服務商接口規(guī)范）：

# 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. 狀態(tài)信息 ：

• code: 響應狀態(tài)碼（200 表示成功，400/500 等為錯誤代碼）。
• message: 狀態(tài)描述（如 "調用成功" 或具體錯誤原因）。
• 商品基礎信息 ：
• id: 商品唯一標識符。
• title: 商品標題。
• price: 當前售價（單位：元）。
• original_price: 原價（若存在折扣）。
• imageUrl: 主圖 URL，支持多圖時為數組格式。
• description: 商品描述（可能包含 HTML 標簽）。
• location: 商品所在地。
• sales: 已售數量。
• status: 商品狀態(tài)（在售、已售出、下架）。
• view_count: 瀏覽量。
• wish_count: 想要數。
• category: 商品分類路徑。
• publish_time: 發(fā)布時間（格式：YYYY-MM-DD HH:MM:SS）。
• 賣家信息 ：
• nick: 賣家昵稱。
• credit_level: 信用等級（極好、優(yōu)秀、良好等）。
• good_rate: 好評率（百分比）。
• seller_id: 加密后的賣家 ID（需通過特定算法解密）。

接口調用注意事項：

1. 身份驗證 ：

• 需提供app_key（應用密鑰）和sign（簽名）。
• 簽名生成規(guī)則：將請求參數按字典序排序，拼接成字符串后使用 [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)

數據來源說明：

• 上述示例基于第三方數據服務商的接口規(guī)范，實際字段可能因接口版本或平臺策略調整而變化。
• 若需獲取官方接口，需通過閑魚開放平臺（[https://open.taobao.com]）申請權限并遵守其開發(fā)者協(xié)議。需要處理分頁邏輯（示例中未展示分頁參數）建議包含錯誤處理機制.

.通過合理使用閑魚item_get接口，開發(fā)者可高效獲取閑魚商品數據，結合業(yè)務場景構建智能電商應用。定期關注接口更新（如字段新增、權限調整），確保服務穩(wěn)定性。

建議在使用前查閱最新接口文檔，并進行充分的測試以確保數據準確性和穩(wěn)定性。

審核編輯 黃宇