一、摘要
闲鱼商品列表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.移动应用集成：为移动应用提供闲鱼商品浏览功能。
