闲鱼商品列表 API 完整指南

一、摘要

闲鱼商品列表 API 是阿里巴巴旗下二手交易平台闲鱼提供的开发者接口，主要用于根据关键词、分类等条件搜索和获取商品列表。该接口支持多种筛选和排序方式，返回 JSON 格式数据，包含商品列表、分页信息等。

二、接口概述

接口名称：goodfish.item_search。

请求方式：GET/Post/Http。

返回格式：JSON。

主要功能：

根据关键词搜索商品

按分类、价格区间等条件筛选

支持多种排序方式（价格、销量、时间等）

获取分页信息

必填参数：q：搜索关键词

sign：基于 app_secret 和请求参数生成的 MD5 签名

可选参数：

cat：商品分类 ID

price_min / price_max：价格区间

sort：排序方式（price_asc, price_desc, sales_desc 等）

page：页码

page_size：每页数量

公共地址:c0b.cc/R4rbK2 。

三、Python 请求示例

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 "

app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词 # 请求示例 url 默认请求参数已经做 URL 编码 url = "goodfish/item_search/?key=<您自己的 apiKey>&&q=女装 &page=1&sort=&price_range=" headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

代码说明：

1.包含完整的签名生成逻辑，确保请求安全性。

2.支持分页参数和搜索条件。

3.提供错误处理机制，增强代码健壮性。

4.返回数据包含商品列表和分页信息。

四、应用场景

1.电商比价工具：通过 API 获取商品价格数据，实现多平台价格对比。

2.数据分析平台：分析商品类别分布、价格趋势等市场数据。

3.商品推荐系统：基于商品数据构建个性化推荐引擎。

4.商家库存管理：监控竞品商品信息，优化自身库存策略。

5.移动应用集成：为移动应用提供闲鱼商品浏览功能。