一、前言

閑魚作為阿里巴巴旗下的二手交易平臺，暫未對外開放官方的商品列表查詢 API。本指南基于對閑魚網頁端 / 移動端網絡請求的逆向分析，提供非官方的商品列表數據獲取思路及 Python 實現方案，僅用于技術學習與研究。

二、接口概述

1. 核心接口信息

項目詳細說明

適用場景按關鍵詞、地區(qū)、價格、排序方式篩選閑魚商品列表

請求方式網頁端：GET（參數拼接在 URL 后）；移動端：POST（參數多為 JSON 格式）

核心 URL網頁端：https://2.taobao.com/item/list.htm（返回 HTML）；

移動端：URL 隨版本迭代頻繁，需自行抓包驗證

返回格式網頁端：HTML（需解析 DOM 元素）；移動端：JSON（易解析，但需登錄態(tài)）

權限要求無需開發(fā)者認證，未登錄狀態(tài)下僅能獲取少量數據，登錄后（攜帶 Cookie）可獲取完整數據

2. 核心請求參數（網頁端）

參數名必填類型說明

keyword是字符串商品搜索關鍵詞（如 “二手 iPad”，需 URL 編碼避免中文亂碼）

page否整數頁碼，默認 1，每頁約 20 條商品

sort否字符串排序方式：default（默認）、price_asc（價格升序）、price_desc（價格降序）

region否字符串地區(qū)篩選（如 “深圳”，需匹配平臺內部地區(qū)編碼，可通過抓包獲?。?/p>

_input_charset否字符串編碼格式，固定為utf8

三、Python 請求示例

# 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 = "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)

代碼關鍵說明

URL 編碼：通過urllib.parse.quote()處理中文關鍵詞，避免請求參數亂碼；

風控規(guī)避：time.sleep(2)控制請求頻率，是避免 IP 被封的核心措施；

容錯處理：每個字段提取都做if判斷，防止因閑魚頁面結構微調導致程序崩潰；

Cookie 獲取：登錄閑魚后，在瀏覽器 F12→Network→任意請求的 Request Headers 中復制 Cookie，添加后可獲取更完整數據；

DOM 適配：若解析不到數據，需打開瀏覽器 F12→Elements，重新定位商品卡片的類名（如.item-mod可能更新）。

四、結語

本指南的接口為非官方實現，其 URL、請求參數、頁面結構均可能隨閑魚平臺迭代失效，需定期通過抓包工具（如 Chrome DevTools、Fiddler）驗證并調整代碼；

移動端接口雖返回 JSON 格式更易解析，但需處理登錄態(tài)、簽名驗證等復雜邏輯，新手建議先從網頁端接口入手；

實際應用中，需完善異常處理（如 IP 代理池、重試機制），進一步降低風控風險，保障程序穩(wěn)定性。

審核編輯 黃宇