1688 跨境寻源通 API 是专为跨境电商打造的供应链数据接口，可实现跨境商品搜索、详情获取、库存 / 价格同步、供应商核验、订单管理等全链路数据采集与对接，适合跨境 ERP、选品系统、采购平台集成。
一、核心能力与适用场景
- 商品寻源：按关键词、类目、价格、目标市场、跨境认证（CE/FDA/RoHS）、物流属性（海外仓 / 代贴标）精准筛选跨境商品。
- 数据同步：实时获取跨境库存、批发价 / 跨境专属价、商品规格，延迟≤10 分钟。
- 供应商核验：查询工厂 / 贸易商资质、履约数据、跨境服务能力。
- 订单管理：创建采购单、查询状态、跟踪物流。
- 货盘服务：获取官方跨境热销货盘。
- 适用场景：跨境选品、ERP 集成、价格监控、供应链对接、自动采购。
二、接入流程（企业开发者）
- 注册认证：1688 开放平台注册企业账号，完成企业实名认证（营业执照）。
- 创建应用 ：新建应用，勾选 "跨境寻源通" 接口权限，获取App Key 与App Secret。
- 获取授权 ：通过 OAuth2.0 获取access_token（有效期 24 小时）。
- 调用接口 ：按规范构造请求、生成签名、发起调用。
三、核心接口清单（跨境专用）
表格
| 接口名称 | 功能 | 关键参数 |
|---|---|---|
| alibaba.crossborder.product.search | 跨境商品搜索 | keywords, category_id, crossborder_attr, price_range, market |
| alibaba.crossborder.product.get | 商品详情 | product_id, fields |
| alibaba.crossborder.product.stock.get | 实时库存 | product_id, sku_id |
| alibaba.crossborder.product.price.get | 价格查询 | product_id, sku_id |
| alibaba.crossborder.supplier.get | 供应商信息 | supplier_id |
| alibaba.crossborder.order.create | 创建采购单 | product_list, address |
| alibaba.crossborder.order.get | 订单查询 | order_id |
四、调用规范（通用）
- 请求地址 ：
https://gw.open.1688.com/openapi/param2/1/[命名空间]/[接口名] - 必选参数 ：
app_key、access_token、method、timestamp、sign - 签名规则：参数按 ASCII 排序→拼接→MD5 加密（32 位大写）
- 频率限制：默认≤1000 次 / 日，可申请扩容
- 数据格式：JSON 返回，支持分页（page_no/page_size）
五、Python 调用示例（商品搜索）
python
运行
import requests
import hashlib
import time
# 配置信息
APP_KEY = "你的AppKey"
APP_SECRET = "你的AppSecret"
ACCESS_TOKEN = "你的AccessToken"
API_URL = "https://gw.open.1688.com/openapi/param2/1/com.alibaba.product/alibaba.crossborder.product.search"
# 构造参数
params = {
"app_key": APP_KEY,
"access_token": ACCESS_TOKEN,
"method": "alibaba.crossborder.product.search",
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"keywords": "3C配件",
"crossborder_attr": "1,2", # 海外仓+合规
"min_price": "10",
"max_price": "100",
"page_no": "1",
"page_size": "50"
}
# 生成签名
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = APP_SECRET + ''.join([f"{k}{v}" for k, v in sorted_params]) + APP_SECRET
sign = hashlib.md5(sign_str.encode()).hexdigest().upper()
params["sign"] = sign
# 发起请求
response = requests.get(API_URL, params=params)
if response.status_code == 200:
data = response.json()
print("商品总数:", data.get("result", {}).get("total", 0))
for item in data.get("result", {}).get("products", []):
print(f"ID: {item['productID']}, 标题: {item['title']}, 价格: {item['price']}")
else:
print(f"请求失败: {response.status_code}, {response.text}")六、数据采集最佳实践
- 批量采集：分页获取，单次≤50 条，控制并发避免限流。
- 增量同步：按更新时间戳增量拉取，减少全量扫描。
- 数据校验：去重、校验价格 / 库存有效性、过滤低质商品。
- 缓存策略：本地缓存热点数据，降低调用频次。
- 合规处理：获取海关编码、认证信息，满足跨境申报要求。
七、常见问题
- 权限不足：检查应用是否勾选跨境寻源通权限、access_token 是否有效。
- 签名错误：确认参数排序、拼接、加密规则正确。
- 调用超限：申请提升频率配额，优化调用逻辑。
- 数据延迟：跨境数据同步≤10 分钟，非实时场景可接受。