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

# coding:utf-8
"""
Compatible for python2.x and python3.x
requirement: pip install requests
"""
from __future__ import print_function
import requests
# API供應(yīng)商demo url=o0b.cn/ibrad
# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(shù)已經(jīng)做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)

關(guān)鍵字段說(shuō)明：

1. 狀態(tài)信息 ：

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

接口調(diào)用注意事項(xiàng)：

1. 身份驗(yàn)證 ：

• 需提供app_key（應(yīng)用密鑰）和sign（簽名）。
• 簽名生成規(guī)則：將請(qǐng)求參數(shù)按字典序排序，拼接成字符串后使用 [MD5] 或 [HMAC-SHA256] 算法加密。
• 參數(shù)要求 ：
• 必選參數(shù)：num_iid（商品 ID）、timestamp（請(qǐng)求時(shí)間戳）。
• 可選參數(shù)：cache（是否使用緩存）、lang（返回語(yǔ)言）等。

示例代碼（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()

# 示例調(diào)用
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)

數(shù)據(jù)來(lái)源說(shuō)明：

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

.通過(guò)合理使用閑魚(yú)item_get接口，開(kāi)發(fā)者可高效獲取閑魚(yú)商品數(shù)據(jù)，結(jié)合業(yè)務(wù)場(chǎng)景構(gòu)建智能電商應(yīng)用。定期關(guān)注接口更新（如字段新增、權(quán)限調(diào)整），確保服務(wù)穩(wěn)定性。

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

審核編輯 黃宇