AI 效率翻倍：对接速卖通接口，商品全量信息一键抓取

一、接口定位（通用 vs 专用）

万邦提供两套速卖通详情接口，推荐优先用通用 item_detail：

通用统一入口（跨平台）

接口名：item_detail

地址：有任何接口问题都可以联系我https://o0b.cn/felix

特点：一套代码通吃速卖通 / 淘宝 / 1688 / 京东，自动识别平台，参数统一，维护成本低

速卖通专用入口（字段最全）

接口名：aliexpress.item_get

地址：https://api-gw.onebound.cn/aliexpress/item_get

特点：跨境专属字段完整（多语言、国际物流、多币种、海外仓），适合深度跨境分析

二、核心功能（AI 跨境价值）

✅ 一键抓取速卖通商品全量结构化数据（60 + 字段）

✅ 跨境专属：多语言标题 / 描述、国际运费、物流时效、海外仓、多币种定价

✅ AI 即用：数据干净结构化，直接喂给大模型做多语言文案生成、跨境选品、价格趋势预测、竞品监控

三、请求地址与必传参数

1）通用 item_detail（推荐）

plaintext

GET https://api-gw.onebound.cn/tool/item_detail

2）速卖通专用 aliexpress.item_get

plaintext

GET https://api-gw.onebound.cn/aliexpress/item_get

3）公共必传参数（所有接口通用）

表格

参数	类型	必填	说明
key	String	✅	你的万邦 API Key
secret	String	✅	你的万邦 API Secret
api_name	String	✅	item_detail 或 aliexpress.item_get
url	String	二选一	速卖通商品完整链接（自动解析，推荐）
num_iid	String	二选一	速卖通商品 ID（数字串，如 1005004863214587）
platform	String	❌	手动指定：aliexpress（不传自动识别）
cache	String	❌	yes/no，默认 yes（缓存加速）
lang	String	❌	en/es/ar/ru/fr，默认 en（多语言返回）

四、速卖通特有参数（专用 item_get）

表格

参数	说明
shipping=1	返回国际物流详情（运费、时效、承运商）
currency=USD	强制返回指定币种价格（USD/EUR/GBP/RUB）
sku_detail=1	返回完整 SKU（规格图、库存、价格、编码）
sales_data=1	返回近 30 天销量、交易额、转化率

五、返回数据结构（跨境核心字段全解）

成功响应（code=200）

json

{
  "code": 200,
  "msg": "success",
  "result": {
    "num_iid": "1005004863214587",  // 商品ID
    "title": "Wireless Bluetooth Headphones Noise Canceling", // 英文标题
    "title_cn": "无线蓝牙耳机降噪",    // 中文翻译标题
    "price": "19.99",                 // 售价（USD）
    "market_price": "39.99",           // 原价
    "currency": "USD",                 // 币种
    "pic_url": "https://ae01.alicdn.com/xxx.jpg", // 主图
    "images": ["图1","图2","图3"],    // 轮播图（5-8张）
    "desc_img": ["详情图1","图2"],    // 详情页长图
    "desc_html": "...",                // 原始HTML描述（多语言）
    "sales": "25000",                  // 总销量
    "month_sales": "6800",             // 月销量
    "stock": "9999",                    // 库存
    "sku": [                            // SKU列表（规格+价格+库存）
      {
        "spec": "Color:Black;Size:One Size",
        "price": "19.99",
        "stock": "1200",
        "sku_id": "123456789"
      }
    ],
    "shipping": {                       // 国际物流（跨境核心）
      "fee": "2.99",                    // 运费
      "time": "15-30 days",            // 时效
      "warehouse": "CN"                 // 发货仓（CN/US/EU）
    },
    "goods_attr": {                     // 商品属性
      "Brand": "Generic",
      "Model": "X10",
      "Connectivity": "Bluetooth 5.3"
    },
    "shop_name": "Tech Global Store",
    "shop_id": "12345678",
    "credit_score": "4.8",              // 店铺评分
    "detail_url": "https://www.aliexpress.com/item/1005004863214587.html"
  }
}

失败响应（常见错误码）

401：key/secret 错误或权限未开通

403：频率超限或余额不足

404：商品不存在 / 已下架 / 链接错误

500：接口内部异常（重试即可）

六、Python 调用示例（复制即用）

1）通用 item_detail（推荐）

python

运行

import requests

API_KEY = "你的key"
API_SECRET = "你的secret"
URL_ALIEXPRESS = "https://www.aliexpress.com/item/1005004863214587.html"

def get_aliexpress_detail():
    url = "https://api-gw.onebound.cn/tool/item_detail"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_detail",
        "url": URL_ALIEXPRESS,
        "platform": "aliexpress",
        "lang": "en"
    }
    resp = requests.get(url, params=params, timeout=20)
    data = resp.json()
    if data["code"] == 200:
        item = data["result"]
        print("英文标题:", item["title"])
        print("售价(USD):", item["price"])
        print("月销量:", item["month_sales"])
        print("运费(USD):", item["shipping"]["fee"])
        return item
    else:
        print("失败:", data["msg"])
        return None

get_aliexpress_detail()

2）速卖通专用 item_get（含物流 / 多币种）

python

运行

params = {
    "key": API_KEY,
    "secret": API_SECRET,
    "api_name": "aliexpress.item_get",
    "num_iid": "1005004863214587",
    "shipping": "1",
    "currency": "USD",
    "sales_data": "1"
}

七、AI 高效用法（跨境直接落地）

批量采集：多线程调用，一次抓 100+ 速卖通商品结构化数据

AI 多语言文案：基于英文标题+属性+详情图，AI 生成西语 / 法语 / 俄语标题与卖点

跨境选品：AI 分析价格/销量/评分/物流时效/竞争度，自动筛跨境爆款

价格监控：定时调用，AI 预警价格波动、库存不足、运费调整

竞品分析：一键抓取竞品全量数据，AI 生成差异化策略报告

审核编辑 黄宇