闲鱼商品详情 API 技术文档

一、前言

闲鱼商品详情 API 是阿里巴巴旗下二手交易平台闲鱼提供的开发者接口，用于通过商品 ID 获取商品的详细信息，包括标题、价格、描述、图片等数据。该接口为开发者提供了便捷的商品信息获取通道，支持多种开发语言调用，本文重点介绍 Python 实现方式。前往体验 API：c0b.cc/R4rbK2 。

二、接口概述

1.接口基本信息

接口名称：goodfish.item_get。

请求方式：GET。

认证方式：需要 app_key 和 app_secret 进行签名验证。

2.主要功能

获取商品基本信息：标题、价格、描述等。

获取卖家信息：昵称、信用等级等。

获取商品图片/视频信息：主图、详情图等。

获取商品分类信息：所属分类、子分类等。

3.返回数据

接口返回 JSON 格式数据，主要包含以下字段：

状态信息：code(状态码)、message(返回消息)。

商品数据：title(标题)、price(价格)、description(描述)。

卖家信息：seller_nick(昵称)、credit_level(信用等级)。

图片/视频：pic_url(图片链接)、video_url(视频链接)。

三、Python 请求示例

以下是使用 Python 调用闲鱼商品详情 API 的完整示例代码：

# 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" num_id = "123456" # 目标商品ID
# 请求示例 url 默认请求参数已经做URL编码 url = "goodfish/item_get/?key=<您自己的apiKey>&num_iid=123456"
headers = { "Accept-Encoding": "gzip", "Connection": "close" }
if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

代码功能说明：

1.签名生成：按照闲鱼 API 规范对请求参数进行排序、拼接和 MD5 加密。

2.请求构造：包含必要的 app_key、item_id 和 timestamp 参数。

3.错误处理：包含 HTTP 状态码和 API 返回状态的检查。

4.数据解析：正确处理返回的 JSON 格式数据。

四、应用场景

1.电商平台集成

为电商平台提供商品信息展示，增加用户购物体验。第三方平台可通过 API 实时同步闲鱼商品数据，丰富平台商品种类。

2.比价工具开发

开发者可以制作比价工具，帮助用户找到性价比最高的二手商品。通过 API 获取实时价格数据，进行多平台价格对比。

3.数据分析应用

通过分析商品信息，进行市场趋势分析、用户行为分析等。可统计热门商品类别、价格分布等数据。 移动应用集成

移动应用可集成该 API，为用户提供便捷的二手商品浏览和购买服务。开发者可构建闲鱼商品搜索、推荐等功能。

4.商家营销工具

帮助商家更好地了解商品情况，提高营销效果。通过 API 获取商品数据，优化商品标题、描述和定价策略。