一、接口概述

1. 接口功能

該接口用于獲取閑魚平臺商品的詳細信息，包括商品標題、價格、規格、賣家信息、庫存狀態、商品描述、圖片鏈接、交易記錄（部分公開數據）等核心字段，支持開發者構建商品監控、競品分析、代購輔助等合規應用。

2. 接口特性

支持獲取公開商品的完整詳情數據，響應格式為 JSON，便于解析；

需通過模擬瀏覽器請求或第三方授權渠道訪問（閑魚無官方公開商品詳情 API）；

存在反爬機制（IP 限制、Cookie 驗證、請求頻率限制），需合規調用；

數據實時性與商品頁面同步，適用于動態監控場景。

3. 返回數據核心字段

字段名類型說明

item_titleString商品標題

item_priceFloat商品標價（單位：元）

item_stockInt庫存數量（部分商品未公開則返回 0）

seller_nickString賣家昵稱

seller_idString賣家唯一 ID

item_descString商品詳細描述（含 HTML 標簽，需解析）

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

item_tagsArray商品標簽（如 “全新”“包郵”“可小刀”）

trade_countInt已成交數量（公開數據）

collect_countInt收藏數

create_timeString商品發布時間（格式：YYYY-MM-DD HH:MM:SS）

locationString賣家所在地

5. 注意事項

閑魚未開放官方商品詳情 API，本接口基于平臺公開頁面的合規爬取方案，需遵守《閑魚平臺用戶服務協議》，不得用于惡意爬取、商業濫用等違規行為；

高頻請求可能導致 IP 被封禁、賬號受限，建議控制請求頻率（如單 IP 每分鐘≤5 次），并使用多個合規賬號輪換 Cookie；

Cookie 有效期約 7-15 天，需定期更新登錄狀態；

部分賣家隱私數據（如手機號、精確地址）會被平臺隱藏，接口無法獲取。

二、請求示例（Python）

1. 環境依賴

需安裝requests庫（用于 HTTP 請求）和json庫（用于數據解析），安裝命令：

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

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

# 請求示例 url 默認請求參數已經做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)

關鍵配置說明

Cookie 獲取方式：打開 Chrome 瀏覽器，登錄閑魚賬號，訪問任意商品頁面 → 按 F12 打開開發者工具 → 切換到 Network 標簽 → 刷新頁面 → 選擇任意請求 → 在 Headers 中找到 Cookie 字段，復制完整內容；

簽名問題：閑魚接口的sign參數需通過淘寶的簽名算法生成（涉及 appKey、secret、時間戳等），上述示例中簡化處理（部分低頻率請求可能無需簽名，高頻率需實現簽名邏輯，可參考第三方開源庫如taobao-sign）；

反爬應對：

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

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

定期更新 Cookie 和 User-Agent，模擬不同用戶訪問。

審核編輯 黃宇