一、接口概述

1. 接口功能

該接口用于獲取閑魚(yú)平臺(tái)商品的詳細(xì)信息，包括商品標(biāo)題、價(jià)格、規(guī)格、賣家信息、庫(kù)存狀態(tài)、商品描述、圖片鏈接、交易記錄（部分公開(kāi)數(shù)據(jù)）等核心字段，支持開(kāi)發(fā)者構(gòu)建商品監(jiān)控、競(jìng)品分析、代購(gòu)輔助等合規(guī)應(yīng)用。

2. 接口特性

支持獲取公開(kāi)商品的完整詳情數(shù)據(jù)，響應(yīng)格式為 JSON，便于解析；

需通過(guò)模擬瀏覽器請(qǐng)求或第三方授權(quán)渠道訪問(wèn)（閑魚(yú)無(wú)官方公開(kāi)商品詳情 API）；

存在反爬機(jī)制（IP 限制、Cookie 驗(yàn)證、請(qǐng)求頻率限制），需合規(guī)調(diào)用；

數(shù)據(jù)實(shí)時(shí)性與商品頁(yè)面同步，適用于動(dòng)態(tài)監(jiān)控場(chǎng)景。

3. 返回?cái)?shù)據(jù)核心字段

字段名類型說(shuō)明

item_titleString商品標(biāo)題

item_priceFloat商品標(biāo)價(jià)（單位：元）

item_stockInt庫(kù)存數(shù)量（部分商品未公開(kāi)則返回 0）

seller_nickString賣家昵稱

seller_idString賣家唯一 ID

item_descString商品詳細(xì)描述（含 HTML 標(biāo)簽，需解析）

item_imagesArray商品圖片鏈接列表（高清圖 URL）

item_tagsArray商品標(biāo)簽（如 “全新”“包郵”“可小刀”）

trade_countInt已成交數(shù)量（公開(kāi)數(shù)據(jù)）

collect_countInt收藏?cái)?shù)

create_timeString商品發(fā)布時(shí)間（格式：YYYY-MM-DD HH:MM:SS）

locationString賣家所在地

5. 注意事項(xiàng)

閑魚(yú)未開(kāi)放官方商品詳情 API，本接口基于平臺(tái)公開(kāi)頁(yè)面的合規(guī)爬取方案，需遵守《閑魚(yú)平臺(tái)用戶服務(wù)協(xié)議》，不得用于惡意爬取、商業(yè)濫用等違規(guī)行為；

高頻請(qǐng)求可能導(dǎo)致 IP 被封禁、賬號(hào)受限，建議控制請(qǐng)求頻率（如單 IP 每分鐘≤5 次），并使用多個(gè)合規(guī)賬號(hào)輪換 Cookie；

Cookie 有效期約 7-15 天，需定期更新登錄狀態(tài)；

部分賣家隱私數(shù)據(jù)（如手機(jī)號(hào)、精確地址）會(huì)被平臺(tái)隱藏，接口無(wú)法獲取。

二、請(qǐng)求示例（Python）

1. 環(huán)境依賴

需安裝requests庫(kù)（用于 HTTP 請(qǐng)求）和json庫(kù)（用于數(shù)據(jù)解析），安裝命令：

bash

pip install requests

2. 完整代碼示例

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function

import requests

# 配置參數(shù) API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "

# 請(qǐng)求示例 url 默認(rèn)請(qǐng)求參數(shù)已經(jīng)做URL編碼 url = "micro/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=2749499386" 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ō)明

Cookie 獲取方式：打開(kāi) Chrome 瀏覽器，登錄閑魚(yú)賬號(hào)，訪問(wèn)任意商品頁(yè)面 → 按 F12 打開(kāi)開(kāi)發(fā)者工具 → 切換到 Network 標(biāo)簽 → 刷新頁(yè)面 → 選擇任意請(qǐng)求 → 在 Headers 中找到 Cookie 字段，復(fù)制完整內(nèi)容；

簽名問(wèn)題：閑魚(yú)接口的sign參數(shù)需通過(guò)淘寶的簽名算法生成（涉及 appKey、secret、時(shí)間戳等），上述示例中簡(jiǎn)化處理（部分低頻率請(qǐng)求可能無(wú)需簽名，高頻率需實(shí)現(xiàn)簽名邏輯，可參考第三方開(kāi)源庫(kù)如taobao-sign）；

反爬應(yīng)對(duì)：

避免高頻請(qǐng)求，建議添加隨機(jī)延遲（如time.sleep(random.uniform(1, 3))）；

使用代理 IP 池輪換 IP（推薦使用高匿代理）；

定期更新 Cookie 和 User-Agent，模擬不同用戶訪問(wèn)。

審核編輯 黃宇