接口简介
苏宁开放平台提供关键字搜索接口，允许开发者通过API获取苏宁平台商品搜索结果。该接口支持按关键词、分类、价格区间等条件筛选商品，返回商品标题、价格、图片等核心信息，适用于商品比价、数据分析等场景。
接口核心参数
请求地址 openapi.suning.com/api/http/ht…
请求方式 POST（推荐）或 GET
公共参数
app_key: 开发者应用的AppKey（需提前注册苏宁开放平台账号并创建应用） access_token: OAuth2.0认证后的访问令牌 method: 接口方法名，如 suning.netalliance.searchcommodity.query timestamp: 请求时间戳（格式：yyyy-MM-dd HH:mm:ss） version: API版本号（如 v1.2）
业务参数
keyword: 搜索关键词（必填，如“手机”） pageNo: 分页页码（默认1） pageSize: 每页数量（默认10，最大100） sortType: 排序方式（如0默认排序，1价格升序，2价格降序） cityCode: 城市编码（用于区域化商品筛选） 代码示例（Python） python Copy Code import requests import json import time
苏宁API配置
app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET" access_token = "YOUR_ACCESS_TOKEN" # 通过OAuth2.0流程获取
构造请求参数
params = { "method": "suning.netalliance.searchcommodity.query", "app_key": app_key, "access_token": access_token, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()), "version": "v1.2", "keyword": "智能手机", "pageNo": 1, "pageSize": 10, "sortType": 1, "cityCode": "025" # 南京城市编码 }
发送POST请求
url = "openapi.suning.com/router/api.…" headers = {"Content-Type": "application/json"} response = requests.post(url, data=json.dumps(params), headers=headers)
解析响应
if response.status_code == 200: result = response.json() if result.get("sn_responseContent", {}).get("sn_error"): print("请求失败:", result["sn_responseContent"]["sn_error"]) else: # 提取商品列表 items = result.get("sn_responseContent", {}).get("sn_body", {}).get("querySearchcommodity", []) for item in items: print(f"商品标题: {item.get('commodityName')}") print(f"价格: ￥{item.get('price')}") print(f"图片URL: {item.get('imgUrl')}") print("------") else: print("请求异常:", response.status_code)
响应数据结构示例 json Copy Code { "sn_responseContent": { "sn_body": { "querySearchcommodity": [ { "commodityName": "Apple iPhone 13 5G智能手机", "price": "5999.00", "imgUrl": "image.suning.cn/uimg/commod…", "productCode": "123456789", "shopId": "SN001" }, // 更多商品数据... ] }, "sn_error": "" } }
注意事项
权限申请 需在苏宁开放平台（open.suning.com）注册开发者账号，创建应用并申请API权限。
签名验证 生产环境中需对请求参数进行签名（示例代码未包含签名逻辑），详细签名算法参考官方文档。
频率限制 默认每秒最大请求数（QPS）为10次，超过可能触发限流。
错误码处理 常见错误如40001（参数缺失）、40002（签名错误）、50001（系统异常），需在代码中兼容处理。
通过本文示例，开发者可快速接入苏宁关键字搜索接口，实现商品数据的自动化查询与整合。建议结合业务需求调整分页、排序等参数，优化搜索效果。
