跨境电商速卖通（AliExpress）数据采集与 API 接口接入全方案

速卖通作为全球主流跨境电商平台，其开放平台 API 是合规采集商品价格、库存、促销等核心数据的首选方式；针对无接口权限场景，也可通过合规爬虫补充采集。以下从API 接口接入（核心）、爬虫采集（补充）、数据处理三个维度完整说明。

一、速卖通开放平台 API 核心特性（补充至跨境电商平台体系）

维度	核心特性
认证方式	基于 App Key + App Secret 的 HMAC-SHA256 签名认证（部分接口支持 OAuth2.0）
核心接口	1. 商品详情：aliexpress.product.redefining.getproductdetail2. 价格 / 促销：aliexpress.offer.redefining.getpricelist3. 运费模板：aliexpress.logistics.redefining.getfreighttemplate4. SKU 信息：aliexpress.product.redefining.getskuinfolist
调用限制	单 App 每日调用限额（普通开发者约 10 万次 / 天），单接口 QPS≤5，IP 无白名单但高频调用易限流
数据特点	支持多站点（如美国、俄罗斯、西班牙站）、多币种（USD/EUR/RUB 等）、多语言，价格含折扣 / 运费拆分
合规要求	需完成企业开发者认证，遵守《速卖通开放平台服务协议》，禁止商用数据倒卖

二、速卖通 API 接口接入（Python 实战）

2.1 前置准备

1. 账号与权限申请
   • 登录速卖通开放平台，完成企业主体认证（需提供营业执照、跨境电商资质）；
   • 创建应用，申请上述核心接口的调用权限（审核周期约 1-3 个工作日）；
   • 记录关键信息：App Key、App Secret、应用授权码（若需 OAuth2.0）。
2. 依赖库安装

   bash

   运行

   pip install requests pycryptodome python-dotenv # 签名/请求/环境变量管理

2.2 Python 封装速卖通 API 客户端（核心代码）

速卖通 API 签名需严格遵循 HMAC-SHA256 算法，且参数需按 ASCII 升序排序，以下是可直接复用的客户端：

python

运行

import requests import time import hmac import hashlib import json from urllib.parse import urlencode, quote from dotenv import load_dotenv import os # 加载环境变量（避免硬编码AppKey/Secret） load_dotenv() APP_KEY = os.getenv("ALI_APP_KEY") APP_SECRET = os.getenv("ALI_APP_SECRET") API_GATEWAY = "https://openapi.aliexpress.com/api" class AliExpressAPIClient: def __init__(self, app_key, app_secret): self.app_key = app_key self.app_secret = app_secret self.session = requests.Session() self.session.headers.update({ "Content-Type": "application/x-www-form-urlencoded; charset=utf-8", "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AliExpressAPI/1.0" }) def generate_sign(self, params): """生成速卖通API签名（HMAC-SHA256）""" # 1. 参数按ASCII升序排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接为"key=value"格式（value需URL编码） sign_str = "&".join([f"{k}={quote(str(v), safe='')}" for k, v in sorted_params]) # 3. HMAC-SHA256加密 + Base64编码 sign = hmac.new( self.app_secret.encode("utf-8"), sign_str.encode("utf-8"), hashlib.sha256 ).digest() return sign.hex().upper() # 转为十六进制大写 def request(self, api_path, params, method="POST", retry=3, delay=2): """发送API请求（含重试机制）""" try: # 补充公共参数 public_params = { "app_key": self.app_key, "timestamp": int(time.time() * 1000), # 毫秒级时间戳 "format": "json", "v": "2.0", "sign_method": "hmac-sha256" } # 合并公共参数与业务参数 all_params = {**public_params, **params} # 生成签名 all_params["sign"] = self.generate_sign(all_params) # 发送请求 if method == "GET": url = f"{API_GATEWAY}{api_path}?{urlencode(all_params)}" response = self.session.get(url, timeout=15) else: url = f"{API_GATEWAY}{api_path}" response = self.session.post(url, data=all_params, timeout=15) response.raise_for_status() result = response.json() # 处理接口错误 if result.get("error_code"): raise Exception(f"API错误：{result['error_code']} - {result['error_message']}") return result except Exception as e: if retry > 0: time.sleep(delay) # 指数退避重试 return self.request(api_path, params, method, retry-1, delay*2) raise Exception(f"调用失败：{str(e)}") def get_product_detail(self, product_id, country="US", currency="USD"): """获取商品详情（含基础价格、名称、SKU）""" api_path = "/aliexpress/product/redefining/getproductdetail" params = { "product_id": product_id, # 速卖通商品ID（从商品页URL提取） "country": country, # 站点国家编码（US/ES/RU等） "currency": currency # 目标币种 } return self.request(api_path, params) def get_product_price(self, product_id, sku_id=""): """获取商品实时价格（含促销价、折扣）""" api_path = "/aliexpress/offer/redefining/getpricelist" params = { "product_id": product_id, "sku_id": sku_id # 空则返回默认SKU价格 } return self.request(api_path, params) def get_freight_template(self, template_id, country="US"): """解析运费模板（计算商品+运费总成本）""" api_path = "/aliexpress/logistics/redefining/getfreighttemplate" params = { "template_id": template_id, "country": country } return self.request(api_path, params) # 调用示例 if __name__ == "__main__": client = AliExpressAPIClient(APP_KEY, APP_SECRET) # 示例：查询商品详情（替换为实际商品ID） product_id = "10050058089xxxx" try: # 1. 获取商品基础信息 detail = client.get_product_detail(product_id, country="US", currency="USD") # 2. 获取价格信息 price = client.get_product_price(product_id) # 3. 获取运费模板（从商品详情中提取template_id） template_id = detail["data"]["freight_template_id"] freight = client.get_freight_template(template_id, country="US") # 解析核心数据（映射为标准字段） result = { "platform_code": "ALIEXPRESS", "product_id": product_id, "product_name": detail["data"]["product_title"], "original_price": price["data"]["original_price"], "current_price": price["data"]["sale_price"], "currency": "USD", "shipping_fee": freight["data"]["default_freight"], "total_price": float(price["data"]["sale_price"]) + float(freight["data"]["default_freight"]) } print(json.dumps(result, ensure_ascii=False, indent=2)) except Exception as e: print(f"采集失败：{e}")

2.3 接口调用关键注意事项

1. 多站点 / 多币种适配：
   • 不同国家站点的价格、运费差异极大（如俄罗斯站定价用 RUB，运费含本地物流费），需通过country参数指定目标站点；
   • 币种转换：可对接第三方汇率接口（如 Open Exchange Rates），将 USD/EUR 等统一转换为 CNY，示例：

     python

     运行

     def convert_currency(amount, from_curr, to_curr="CNY"): # 对接汇率接口获取实时汇率（示例为固定汇率，需替换为真实接口） exchange_rates = {"USD": 7.2, "EUR": 7.8, "RUB": 0.07} return amount * exchange_rates[from_curr]

2. 签名排错：
   • 若返回 “签名无效”，检查：参数排序是否升序、value 是否 URL 编码、时间戳是否为毫秒级、AppSecret 是否正确；
3. 频率控制：
   • 新增 Redis 限流逻辑（参考京东 API 的限流代码），控制单接口 QPS≤5，避免触发平台限流（返回 429 错误）。

三、无接口权限时的合规爬虫采集（补充方案）

若暂未获取 API 权限，可通过爬虫采集速卖通商品页数据（需严格遵守 robots 协议，仅用于非商用监控）：

3.1 核心爬虫代码（应对动态渲染）

python

运行

import requests from selenium import webdriver from selenium.webdriver.common.by import By from selenium.webdriver.support.wait import WebDriverWait from selenium.webdriver.support import expected_conditions as EC import time from fake_useragent import UserAgent class AliExpressSpider: def __init__(self): self.ua = UserAgent() # 配置ChromeOptions（反爬） self.options = webdriver.ChromeOptions() self.options.add_argument(f"user-agent={self.ua.random}") self.options.add_argument("--headless") # 无头模式 self.options.add_experimental_option("excludeSwitches", ["enable-automation"]) self.driver = webdriver.Chrome(options=self.options) self.driver.implicitly_wait(10) def get_product_data(self, product_url): """采集商品页数据（示例：价格、名称、运费）""" try: self.driver.get(product_url) # 等待价格元素加载（应对JS动态渲染） price_elem = WebDriverWait(self.driver, 15).until( EC.presence_of_element_located((By.CLASS_NAME, "product-price-value")) ) # 提取数据 product_name = self.driver.find_element(By.CLASS_NAME, "product-title-text").text.strip() current_price = price_elem.text.strip().replace("$", "") shipping_fee = self.driver.find_element(By.CLASS_NAME, "product-shipping-price").text.strip() return { "product_name": product_name, "current_price": current_price, "shipping_fee": shipping_fee, "url": product_url } except Exception as e: raise Exception(f"爬虫采集失败：{e}") finally: self.driver.quit() # 调用示例 if __name__ == "__main__": spider = AliExpressSpider() product_url = "https://www.aliexpress.com/item/10050058089xxxx.html" print(spider.get_product_data(product_url))

3.2 爬虫反爬应对策略

1. IP 代理轮换：使用跨境代理池（如 911S5、BrightData），避免单 IP 被封（速卖通对境外 IP 更宽松，境内 IP 易受限）；
2. 请求延迟：每次请求间隔 10-15 秒，避免高频；
3. 绕过检测：禁用 Chrome 自动化标识（enable-automation），配合随机 User-Agent、Cookie 池。

四、数据采集合规与风险控制

1. 合规底线：
   • 仅采集公开商品数据，禁止爬取用户隐私、订单信息；
   • 数据仅用于自身价格监控，禁止倒卖、商用；
2. 风险应对：
   • API 权限被限：预留备用开发者账号，及时调整调用频率；
   • 爬虫被封：优先切换至 API 方案，或降低采集频率；
   • 数据延迟：速卖通 API 数据延迟约 5-10 分钟，爬虫数据为实时但稳定性低，建议两者结合校验。

五、总结

速卖通数据采集优先选择开放平台 API（稳定、合规、数据完整），爬虫仅作为临时补充方案；核心需解决多站点 / 多币种适配、签名认证、运费模板解析三大问题，同时严格控制调用频率，确保符合平台规则。若需对接速卖通订单、库存等更深层数据，可进一步申请高级接口权限，并完善数据加密、日志监控体系。