速卖通商品详情数据 API 接口全解——注册、签名、Python 调用到落库一条龙

关键词：AliExpress、aliexpress.item.get、官方 OpenAPI、跨境电商、Python 示例、合规限速
适用：比价 SaaS、ERP 选品、数据分析、第三方金融评估

一、接口能拿到什么数据？

速卖通开放平台提供 aliexpress.item.get，一次调用可回 30+ 字段：

二、0→1 准备工作

三、技术画像

网关: https://gw.api.aliexpress.com/routerjson (固定)
Method: aliexpress.item.get
必参: app_key, timestamp, sign, method, v=1.0, format=json, num_iid
签名: HMAC-SHA256（新）或 MD5（旧），需排序后拼接 [^20^][^22^]
返回: JSON，UTF-8，gzip 压缩
频率: 默认 1 000 次/天，购买资源包可升至 10 万/天

四、Python 实战：30 行拿到商品 JSON

# pip install requests
import time, json, hashlib, hmac, requests
from urllib.parse import urlencode

APP_KEY = '你的AppKey'
APP_SECRET = '你的AppSecret'
GATEWAY = 'https://gw.api.aliexpress.com/routerjson'

def sha256_sign(params: dict) -> str:
"""HMAC-SHA256 签名（官方推荐）"""
params = {k: v for k, v in params.items() if v is not None}
sorted_str = urlencode(sorted(params.items()))
sig = hmac.new(APP_SECRET.encode(), sorted_str.encode(),
hashlib.sha256).hexdigest().upper()
return sig

def item_get(num_iid: str):
p = {
"method" : "aliexpress.item.get",
"app_key" : APP_KEY,
"timestamp" : time.strftime("%Y-%m-%d %H:%M:%S"),
"v" : "1.0",
"format" : "json",
"sign_method": "hmac_sha256",
"num_iid" : num_iid,
"fields" : "title,price,sku,image_urls,stock,commission_rate"
}
p["sign"] = sha256_sign(p)
r = requests.get(GATEWAY, params=p, timeout=10)
r.raise_for_status()
return r.json()["aliexpress_item_get_response"]["result"]

if __name__ == "__main__":
data = item_get("1005005517123456")
print(json.dumps(data, indent=2, ensure_ascii=False))

运行结果（节选）：

{
"product_id": 1005005517123456,
"title": "Bluetooth 5.3 Wireless Earbuds",
"sale_price": 12.47,
"currency": "USD",
"stock": 12580,
"sku": […],
"commission_rate": 8.5
}

五、批量链路：搜索 → 详情 → 落库

六、常见错误码速查

七、合规与风控（第三方重点）