跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonSaaS

速卖通商品详情 API 接口详解:注册、签名与 Python 调用示例

综述由AI生成速卖通开放平台商品详情 API(aliexpress.item.get)的接入流程。涵盖开发者注册、权限申请、OAuth2.0 认证及 HMAC-SHA256 签名方法。提供完整的 Python 调用代码示例,展示如何获取商品标题、价格、SKU 等核心字段。此外,文章还介绍了批量抓取链路设计(搜索 - 详情 - 落库)、并发控制策略、常见错误码处理以及数据合规与风控要求,适用于跨境电商 ERP、比价系统及数据分析场景。

Qiny01发布于 2026/3/28更新于 2026/5/2628 浏览
速卖通商品详情 API 接口详解:注册、签名与 Python 调用示例

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

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

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

  1. 基础:商品标题、一口价/原价、折扣率、主图 URL、币种
  2. SKU:各规格库存、阶梯价、属性图、尺码/颜色绑定
  3. 物流:运费模板、海外仓、预计妥投时间
  4. 营销:促销标签、历史最低价、佣金率
  5. 评价:评分、评论数、带图评价比例
  6. 多语言:支持英/西/俄等 8 种返回,利于本土化

二、0→1 准备工作

步骤说明地址/备注
① 注册开发者企业认证 QPS 更高-
② 创建应用选'商品数据'权限得到 AppKey + AppSecret
③ 申请权限搜索 aliexpress.item.get审核 1-3 天
④ 获取 tokenOAuth2.0 或商家授权部分接口可省

三、技术画像

网关: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(旧),需排序后拼接
返回:JSON,UTF-8,gzip 压缩
频率:默认 1000 次/天,购买资源包可升至 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'

 () -> :
    
    params = {k: v  k, v  params.items()  v   }
    sorted_str = urlencode((params.items()))
    sig = hmac.new(APP_SECRET.encode(), sorted_str.encode(), hashlib.sha256).hexdigest().upper()
     sig

 ():
    p = {
        : ,
        : APP_KEY,
        : time.strftime(),
        : ,
        : ,
        : ,
        : num_iid,
        : 
    }
    p[] = sha256_sign(p)
    r = requests.get(GATEWAY, params=p, timeout=)
    r.raise_for_status()
     r.json()[][]

 __name__ == :
    data = item_get()
    (json.dumps(data, indent=, ensure_ascii=))
def
sha256_sign
params: dict
str
"""HMAC-SHA256 签名(官方推荐)"""
for
in
if
is
not
None
sorted
return
def
item_get
num_iid: str
"method"
"aliexpress.item.get"
"app_key"
"timestamp"
"%Y-%m-%d %H:%M:%S"
"v"
"1.0"
"format"
"json"
"sign_method"
"hmac_sha256"
"num_iid"
"fields"
"title,price,sku,image_urls,stock,commission_rate"
"sign"
10
return
"aliexpress_item_get_response"
"result"
if
"__main__"
"1005005517123456"
print
2
False

运行结果(节选):

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

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

  1. 搜索端:用 aliexpress.item.search 按关键词/品类/价格区间抓商品 ID 列表
  2. 详情端:for 循环调 item_get,并发≤5、QPS≤1 保平安
  3. 存储:MySQL 按 product_id 主键 INSERT ... ON DUPLICATE KEY UPDATE
  4. 缓存:Redis 记录'最近 1h 已抓'ID,防止重复烧额度

六、常见错误码速查

返回码含义解决
401sign 错误检查时间戳误差>10 min 或签错算法
429流量超限降速 + 买资源包
561商品不存在ID 写错或已下架
5611店铺关闭跳过该 ID

七、合规与风控(第三方重点)

  1. 数据归属——谁的数据谁授权;未授权商品 ID 不抓取
  2. 最小可用字段——只申请业务必需的 fields,减少隐私风险
  3. 频率封顶——默认 1000/天,超限需购买独立资源包,不得多 AppKey 分摊
  4. 落地脱敏——买家昵称、邮箱、电话等个人字段不落盘
  5. 再分发限制——接口返回数据不可直接打包出售,只能'结果化展示'给终端用户
  6. 定期审计——平台会抽查调用日志,异常需 24h 内整改

目录

  1. 一、接口能拿到什么数据?
  2. 二、0→1 准备工作
  3. 三、技术画像
  4. 四、Python 实战:30 行拿到商品 JSON
  5. pip install requests
  6. 五、批量链路:搜索 → 详情 → 落库
  7. 六、常见错误码速查
  8. 七、合规与风控(第三方重点)
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • SpringBoot 源码解析:AnnotationConfigServletWebServerApplicationContext 构造流程
  • 利用 AI 与轻量化工具优化开发团队协同流程
  • 插入排序算法原理与 Java 实现
  • 动态规划路径类 DP 入门:3 道经典例题详解
  • 动态规划经典例题:三步问题、第 N 个泰波那契数与最小花费爬楼梯
  • 基于 Python Vue3 Django 的 KTV 包厢服务管理系统
  • 无需公网 IP 安全远程访问本地 AI 服务方案
  • 大疆无人机反制手段解析:干扰枪与激光武器效果对比
  • 无需公网 IP 安全访问本地 AI 服务的方案与实践
  • 我国网络安全人才市场供需趋势与特征分析
  • Unreal Engine 4.27 结合 AirSim 搭建澳洲农村无人机仿真环境
  • PyWebIO 表格数据展示与高效可视化实践
  • C++ Boost 搜索引擎:正倒排索引核心实现与详解
  • DES 加密算法原理详解、攻击手段及 3DES 原理
  • Stable Diffusion 入门:稳定生成人物脸部与姿势控制技巧
  • KingbaseES 处理 PL/SQL 运行时错误:异常捕获与处理实践
  • Python unstructured 库:处理非结构化数据并转换为结构化格式
  • 国内大模型公司面试经验与考点总结
  • 通义万相 2.1 多模态生成技术解析与应用前景
  • Java 后端转 Web3 实战路线图

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online