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

萬邦提供兩套速賣通詳情接口，推薦優(yōu)先用通用 item_detail：

通用統(tǒng)一入口（跨平臺(tái)）

接口名：item_detail

地址：有任何接口問題都可以聯(lián)系我https://o0b.cn/felix

特點(diǎn)：一套代碼通吃速賣通 / 淘寶 / 1688 / 京東，自動(dòng)識(shí)別平臺(tái)，參數(shù)統(tǒng)一，維護(hù)成本低

速賣通專用入口（字段最全）

接口名：aliexpress.item_get

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

特點(diǎn)：跨境專屬字段完整（多語言、國際物流、多幣種、海外倉），適合深度跨境分析

二、核心功能（AI 跨境價(jià)值）

? 一鍵抓取速賣通商品全量結(jié)構(gòu)化數(shù)據(jù)（60 + 字段）

? 跨境專屬：多語言標(biāo)題 / 描述、國際運(yùn)費(fèi)、物流時(shí)效、海外倉、多幣種定價(jià)

? AI 即用：數(shù)據(jù)干凈結(jié)構(gòu)化，直接喂給大模型做多語言文案生成、跨境選品、價(jià)格趨勢(shì)預(yù)測(cè)、競(jìng)品監(jiān)控

三、請(qǐng)求地址與必傳參數(shù)

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）公共必傳參數(shù)（所有接口通用）

表格

四、速賣通特有參數(shù)（專用 item_get）

表格

五、返回?cái)?shù)據(jù)結(jié)構(gòu)（跨境核心字段全解）

成功響應(yīng)（code=200）

json

{
  "code": 200,
  "msg": "success",
  "result": {
    "num_iid": "1005004863214587",  // 商品ID
    "title": "Wireless Bluetooth Headphones Noise Canceling", // 英文標(biāo)題
    "title_cn": "無線藍(lán)牙耳機(jī)降噪",    // 中文翻譯標(biāo)題
    "price": "19.99",                 // 售價(jià)（USD）
    "market_price": "39.99",           // 原價(jià)
    "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列表（規(guī)格+價(jià)格+庫存）
      {
        "spec": "Color:Black;Size:One Size",
        "price": "19.99",
        "stock": "1200",
        "sku_id": "123456789"
      }
    ],
    "shipping": {                       // 國際物流（跨境核心）
      "fee": "2.99",                    // 運(yùn)費(fèi)
      "time": "15-30 days",            // 時(shí)效
      "warehouse": "CN"                 // 發(fā)貨倉（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",              // 店鋪評(píng)分
    "detail_url": "https://www.aliexpress.com/item/1005004863214587.html"
  }
}

失敗響應(yīng)（常見錯(cuò)誤碼）

401：key/secret 錯(cuò)誤或權(quán)限未開通

403：頻率超限或余額不足

404：商品不存在 / 已下架 / 鏈接錯(cuò)誤

500：接口內(nèi)部異常（重試即可）

六、Python 調(diào)用示例（復(fù)制即用）

1）通用 item_detail（推薦）

python

運(yùn)行

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("英文標(biāo)題:", item["title"])
        print("售價(jià)(USD):", item["price"])
        print("月銷量:", item["month_sales"])
        print("運(yùn)費(fèi)(USD):", item["shipping"]["fee"])
        return item
    else:
        print("失敗:", data["msg"])
        return None

get_aliexpress_detail()

2）速賣通專用 item_get（含物流 / 多幣種）

python

運(yùn)行

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

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

批量采集：多線程調(diào)用，一次抓 100+ 速賣通商品結(jié)構(gòu)化數(shù)據(jù)

AI 多語言文案：基于英文標(biāo)題+屬性+詳情圖，AI 生成西語 / 法語 / 俄語標(biāo)題與賣點(diǎn)

跨境選品：AI 分析價(jià)格/銷量/評(píng)分/物流時(shí)效/競(jìng)爭(zhēng)度，自動(dòng)篩跨境爆款

價(jià)格監(jiān)控：定時(shí)調(diào)用，AI 預(yù)警價(jià)格波動(dòng)、庫存不足、運(yùn)費(fèi)調(diào)整

競(jìng)品分析：一鍵抓取競(jìng)品全量數(shù)據(jù)，AI 生成差異化策略報(bào)告

審核編輯 黃宇