一、前言

閑魚作為阿里巴巴旗下的二手交易平臺(tái)，暫未對(duì)外開放官方的商品列表查詢 API。本指南基于對(duì)閑魚網(wǎng)頁端 / 移動(dòng)端網(wǎng)絡(luò)請(qǐng)求的逆向分析，提供非官方的商品列表數(shù)據(jù)獲取思路及 Python 實(shí)現(xiàn)方案，僅用于技術(shù)學(xué)習(xí)與研究。

二、接口概述

1. 核心接口信息

項(xiàng)目詳細(xì)說明

適用場(chǎng)景按關(guān)鍵詞、地區(qū)、價(jià)格、排序方式篩選閑魚商品列表

請(qǐng)求方式網(wǎng)頁端：GET（參數(shù)拼接在 URL 后）；移動(dòng)端：POST（參數(shù)多為 JSON 格式）

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

移動(dòng)端：URL 隨版本迭代頻繁，需自行抓包驗(yàn)證

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

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

2. 核心請(qǐng)求參數(shù)（網(wǎng)頁端）

參數(shù)名必填類型說明

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

page否整數(shù)頁碼，默認(rèn) 1，每頁約 20 條商品

sort否字符串排序方式：default（默認(rèn)）、price_asc（價(jià)格升序）、price_desc（價(jià)格降序）

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

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

三、Python 請(qǐng)求示例

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

URL 編碼：通過urllib.parse.quote()處理中文關(guān)鍵詞，避免請(qǐng)求參數(shù)亂碼；

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

容錯(cuò)處理：每個(gè)字段提取都做if判斷，防止因閑魚頁面結(jié)構(gòu)微調(diào)導(dǎo)致程序崩潰；

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

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

四、結(jié)語

本指南的接口為非官方實(shí)現(xiàn)，其 URL、請(qǐng)求參數(shù)、頁面結(jié)構(gòu)均可能隨閑魚平臺(tái)迭代失效，需定期通過抓包工具（如 Chrome DevTools、Fiddler）驗(yàn)證并調(diào)整代碼；

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

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

審核編輯 黃宇