当前位置：首页 > article >正文

苏宁开放平台关键字搜索接口接入教程‌

article 2025/3/31 19:21:33

接口简介‌

苏宁开放平台提供‌关键字搜索接口‌，允许开发者通过API获取苏宁平台商品搜索结果。该接口支持按关键词、分类、价格区间等条件筛选商品，返回商品标题、价格、图片等核心信息，适用于商品比价、数据分析等场景。

接口核心参数‌

请求地址‌
https://openapi.suning.com/api/http/https://openapi.suning.com/router/api.gateway

请求方式‌
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 = "https://openapi.suning.com/router/api.gateway"
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": "https://image.suning.cn/uimg/commodity/iphone13.jpg",
                    "productCode": "123456789",
                    "shopId": "SN001"
                },
                // 更多商品数据...
            ]
        },
        "sn_error": ""
    }
}