一、接口摘要
闲鱼商品详情API是阿里巴巴旗下二手交易平台闲鱼提供的开发者接口,主要用于通过商品ID获取商品的详细信息。该接口支持多种开发语言调用,返回JSON格式数据,包含商品基本信息、卖家信息、图片视频等内容。
二、公开商品详情查询 API(数据服务商,适合选品、监控、比价,你业务常用)
1.主流接口名称:goodfish.item_get
请求方式:GET
入参核心:
num_iid(Goofish 商品 ID,由搜索接口 goodfish.item_get 拿到)公共参数:key、secret、api_name=goodfish.item_get
返回字段:标题、售价、原价、sku、详情描述、多图、类目 category_id/parent_id、卖家信息、发布时间、浏览收藏、商品属性 props 等
2.公共地址:http://o0b.cn/ibrad
三、Python标准调用示例
# coding:utf-8
""" Compatible for python2.x and python3.x requirement: pip install requests """
from __future__ import print_function import requests
# 配置参数 API_URL = "http://o0b.cn/ibrad "
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)
代码实现了一个完整的闲鱼API调用类,主要功能包括:可返回核心字段
基础:num_iid、title、price、original_price、pic_url、desc
类目:category_id、parent_id、category_name(正好你前面问的三个字段)
属性:商品属性 prop(对标淘宝 taobao.itempropvalues.get)
卖家:seller_nick、seller_id、信用信息
规格:sku 列表、库存、运费
四、结余
闲鱼商品详情API为开发者提供了标准化的商品数据获取渠道,支持多种应用场景开发。在实际使用中,开发者需要关注官方文档更新,确保接口调用的准确性和合规性。同时需要注意API调用频率限制,合理处理错误响应,保证应用的稳定运行。
五、补充区分
Goofish:海外闲鱼(香港 / 东南亚),独立站点,商品体系独立
Xianyu: 国内闲鱼,二者接口不能互通