1688平台商品搜索API接口技术解析

​

一、接口概述

1688开放平台提供alibaba.product.searchAPI接口，支持通过关键词获取商品列表。需注意：

需企业认证账号申请appKey和appSecret

数据返回格式为JSON

支持分页参数控制数据量

二、核心请求参数

{
  "keywords": "手机支架",  // 搜索关键词
  "pageNo": 1,            // 页码
  "pageSize": 20,         // 每页数量
  "sortType": "total",    // 排序方式
  "priceStart": 10.0,     // 价格区间
  "priceEnd": 100.0
}

三、技术实现步骤

身份认证

import hashlib
import time

def generate_sign(params, app_secret):
    param_str = '&'.join([f"{k}{v}" for k,v in sorted(params.items())])
    return hashlib.md5((app_secret + param_str + app_secret).encode()).hexdigest().upper()

API请求示例

import requests

def search_1688_product(keyword):
    base_url = "https://gw.open.1688.com/openapi/param2/2/portals.open/api.listOfferDetail/"
    params = {
        "keywords": keyword,
        "pageNo": 1,
        "pageSize": 50,
        "appKey": "YOUR_APP_KEY",
        "timestamp": int(time.time() * 1000)
    }
    params["sign"] = generate_sign(params, "YOUR_APP_SECRET")
    
    response = requests.get(base_url, params=params)
    return response.json()

四、响应数据结构解析

{
  "result": {
    "totalResults": 1200,
    "offerList": [
      {
        "productId": 123456789,
        "subject": "铝合金手机支架",
        "price": 15.80,
        "minOrder": 100,
        "imageUrl": "https://img.alicdn.com/xxx.jpg",
        "companyName": "某某科技"
      }
    ]
  }
}

五、技术注意事项

请求限制

默认QPS≤2（每秒请求数）

单日调用上限需参照合同约定

错误处理

if response.status_code != 200:
    raise Exception(f"API请求失败: {response.status_code}")

if 'error' in data:
    error_code = data['error']['code']
    # 常见错误码处理
    if error_code == 15: 
        print("请求频率超限")

六、最佳实践建议

使用pageSize+pageNo实现分页采集

通过priceStart/priceEnd过滤无效数据

添加延时避免触发风控：

import random
time.sleep(random.uniform(0.5, 1.2))

法律声明：使用API需遵守《1688开放平台开发者协议》，禁止爬取非授权数据。本文示例仅作技术交流，实际调用需申请官方授权。

通过合理使用API接口，可高效获取商品基础信息、价格趋势、供应商数据等核心商业情报，为电商分析系统提供数据支持。

​审核编辑 黄宇