?

一、核心前提：開(kāi)通萬(wàn)邦賬號(hào)，拿到 key/secret

注冊(cè)萬(wàn)邦（Onebound）賬號(hào)：訪(fǎng)問(wèn) open.onebound.cn 注冊(cè)、實(shí)名認(rèn)證、開(kāi)通淘寶商品詳情 API 權(quán)限（item_get/item_detail）

獲取密鑰：控制臺(tái) → 應(yīng)用管理 → 拿到你的 key 和 secret（這兩個(gè)是調(diào)用必須憑證，保密）

測(cè)試額度：先領(lǐng)免費(fèi)測(cè)試額度，驗(yàn)證通了再買(mǎi)正式套餐

二、接口選擇（淘寶詳情）

基礎(chǔ)版：taobao.item_get（獲取標(biāo)題、價(jià)格、主圖、SKU、詳情圖、店鋪等核心字段）

通用統(tǒng)一版：item_detail（跨平臺(tái)統(tǒng)一入口，自動(dòng)識(shí)別淘寶，和 1688 / 京東 / 小紅書(shū)同套參數(shù)）

高級(jí)版：taobao.item_get_pro（含更多擴(kuò)展字段、歷史價(jià)格、屬性圖等）

統(tǒng)一請(qǐng)求地址（推薦通用 item_detail）

plaintext

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

淘寶專(zhuān)用地址（item_get）

plaintext

https://api-gw.onebound.cn/taobao/item_get

三、必傳請(qǐng)求參數(shù)（二選一，最簡(jiǎn)單用 url）

表格

四、完整調(diào)用示例（Python，復(fù)制即用）

python

運(yùn)行

import requests

# 1. 替換成你的萬(wàn)邦key/secret
API_KEY = "你的key"
API_SECRET = "你的secret"
# 淘寶商品鏈接/ID
TAOBAO_URL = "https://item.taobao.com/item.htm?id=784567890123"
# TAOBAO_NUM_IID = "784567890123"  # 也可以直接傳商品ID

def get_taobao_detail():
    url = "https://api-gw.onebound.cn/tool/item_detail"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_detail",
        "url": TAOBAO_URL,
        # "num_iid": TAOBAO_NUM_IID,  # 二選一
        "platform": "taobao"
    }
    try:
        resp = requests.get(url, params=params, timeout=20)
        resp.raise_for_status()
        data = resp.json()
        if data.get("code") == 200:
            item = data["result"]
            # 提取你需要的字段
            print("? 商品標(biāo)題:", item.get("title"))
            print("? 售價(jià):", item.get("price"))
            print("? 原價(jià):", item.get("market_price"))
            print("? 主圖:", item.get("pic_url"))
            print("? 銷(xiāo)量:", item.get("sales"))
            print("? SKU數(shù)量:", len(item.get("sku", [])))
            print("? 詳情圖:", len(item.get("desc_img", [])))
            return item
        else:
            print("? 失敗:", data.get("msg"), "code:", data.get("code"))
            return None
    except Exception as e:
        print("請(qǐng)求異常:", e)
        return None

if __name__ == "__main__":
    get_taobao_detail()

五、返回核心字段（全量信息）

json

{
  "code": 200,
  "result": {
    "num_iid": "784567890123",       // 商品ID
    "title": "商品完整標(biāo)題",
    "price": "199.00",               // 售價(jià)
    "market_price": "299.00",         // 原價(jià)
    "pic_url": "https://xxx.jpg",     // 主圖
    "images": ["圖1","圖2","圖3"],    // 輪播圖
    "desc_img": ["詳情圖1","圖2"],    // 詳情頁(yè)圖片
    "sales": "12345",                 // 銷(xiāo)量
    "stock": "999",                   // 庫(kù)存
    "sku": [                          // SKU規(guī)格（顏色、尺碼、價(jià)格、庫(kù)存）
      {"spec": "顏色:紅色;尺碼:L", "price": "199", "stock": "100"}
    ],
    "goods_attr": "品牌:XX;材質(zhì):棉...", // 規(guī)格參數(shù)
    "shop_name": "XX旗艦店",
    "seller_id": "12345678",
    "detail_url": "原商品鏈接"
  }
}

六、常見(jiàn)問(wèn)題與避坑

401/403 鑒權(quán)失敗：檢查 key/secret 是否正確、是否開(kāi)通淘寶權(quán)限、是否過(guò)期 / 欠費(fèi)

返回空 / 無(wú)數(shù)據(jù)：確認(rèn)商品鏈接 /num_iid 正確、商品未下架、平臺(tái)未風(fēng)控

調(diào)用頻率限制：按套餐 QPS / 日限控制，不要并發(fā)過(guò)高，加重試 / 隊(duì)列

數(shù)據(jù)不全：基礎(chǔ)版item_get夠用，要更全字段用item_get_pro

七、快速測(cè)試（不用寫(xiě)代碼）

直接在瀏覽器 / Postman 拼鏈接測(cè)試：

plaintext

https://api-gw.onebound.cn/tool/item_detail?key=你的key&secret=你的secret&api_name=item_detail&url=https://item.taobao.com/item.htm?id=784567890123

要不要我給你整理一份萬(wàn)邦淘寶 item_detail 的完整字段清單 + Postman 導(dǎo)入配置，直接導(dǎo)入就能一鍵測(cè)試？

AI接口詳解1688 通用商品詳情

下面給你一份萬(wàn)邦（龍蝦 / Onebound）1688 通用商品詳情接口 item_detail /item_get 的完整詳解，從接口定位、地址、參數(shù)、返回字段、調(diào)用示例到 AI 場(chǎng)景用法，一次性講全，直接可用。

一、接口定位（通用 vs 專(zhuān)用）

萬(wàn)邦提供兩套 1688 詳情接口：

通用統(tǒng)一入口（推薦）

接口名：item_detail

地址：https://api-gw.onebound.cn/tool/item_detail

特點(diǎn)：跨平臺(tái)統(tǒng)一參數(shù)，自動(dòng)識(shí)別 1688 / 淘寶 / 京東，一套代碼跑全平臺(tái)

1688 專(zhuān)用入口

接口名：1688.item_get

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

特點(diǎn)：1688 字段最全，B2B 批發(fā)屬性（起批量、階梯價(jià)、代發(fā)價(jià)）完整

下文以 通用 item_detail 為主，同時(shí)標(biāo)注 1688 專(zhuān)用差異。

二、核心功能（AI 場(chǎng)景價(jià)值）

一鍵獲取 1688 商品全量結(jié)構(gòu)化數(shù)據(jù)（50 + 字段）

B2B 專(zhuān)屬：起批量 MOQ、階梯價(jià)、分銷(xiāo)代發(fā)價(jià)、定制屬性

AI 適配：數(shù)據(jù)干凈、結(jié)構(gòu)化，可直接喂給大模型做選品分析、標(biāo)題生成、文案提煉、價(jià)格預(yù)測(cè)

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

1）通用 item_detail（跨平臺(tái)）

plaintext

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

2）1688 專(zhuān)用 item_get

plaintext

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

3）公共必傳參數(shù)（所有接口通用）

表格

四、1688 特有參數(shù)（專(zhuān)用 item_get）

表格

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

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

json

{
  "code": 200,
  "msg": "success",
  "result": {
    "num_iid": "610947572360",       // 商品ID
    "title": "2026新款夏季純棉T恤女 寬松大碼百搭上衣 工廠(chǎng)批發(fā)", // 標(biāo)題
    "price": "35.00",                 // 批發(fā)參考價(jià)
    "market_price": "89.00",           // 專(zhuān)柜價(jià)/原價(jià)
    "min_order": "2",                  // 起批量 MOQ（B2B核心）
    "pic_url": "https://g.alicdn.com/xxx.jpg", // 主圖
    "images": ["圖1","圖2","圖3"],    // 輪播圖（5-8張）
    "desc_img": ["詳情圖1","圖2"],    // 詳情頁(yè)長(zhǎng)圖
    "sales": "12500",                 // 總銷(xiāo)量
    "month_sales": "3200",            // 月銷(xiāo)量（近30天）
    "stock": "9999",                   // 總庫(kù)存
    "sku": [                           // SKU列表（規(guī)格+價(jià)格+庫(kù)存）
      {
        "spec": "顏色:白色;尺碼:M",
        "price": "35.00",
        "stock": "1200",
        "sku_id": "123456789"
      }
    ],
    "price_range": [                   // 階梯價(jià)（B2B核心）
      {"min_num": "2", "price": "35.00"},
      {"min_num": "10", "price": "32.00"},
      {"min_num": "50", "price": "29.00"}
    ],
    "agent_price": "33.00",            // 代發(fā)價(jià)（agent=1時(shí)返回）
    "goods_attr": {                    // 商品屬性（材質(zhì)/尺碼/品牌）
      "品牌": "自主",
      "材質(zhì)": "純棉",
      "尺碼": "M/L/XL/XXL"
    },
    "shop_name": "XX服飾工廠(chǎng)店",
    "shop_id": "12345678",
    "credit_score": "4.9",             // 店鋪評(píng)分
    "detail_url": "https://detail.1688.com/offer/610947572360.html"
  }
}

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

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

403：頻率超限或余額不足

404：商品不存在 / 已下架

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

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

1）通用 item_detail（推薦）

python

運(yùn)行

import requests

API_KEY = "你的key"
API_SECRET = "你的secret"
URL_1688 = "https://detail.1688.com/offer/610947572360.html"

def get_1688_detail():
    url = "https://api-gw.onebound.cn/tool/item_detail"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_detail",
        "url": URL_1688,
        "platform": "1688"
    }
    resp = requests.get(url, params=params, timeout=20)
    data = resp.json()
    if data["code"] == 200:
        item = data["result"]
        print("標(biāo)題:", item["title"])
        print("批發(fā)價(jià):", item["price"])
        print("起批量:", item["min_order"])
        print("月銷(xiāo)量:", item["month_sales"])
        return item
    else:
        print("失敗:", data["msg"])
        return None

get_1688_detail()

2）1688 專(zhuān)用 item_get（含代發(fā)價(jià)）

python

運(yùn)行

params = {
    "key": API_KEY,
    "secret": API_SECRET,
    "api_name": "1688.item_get",
    "num_iid": "610947572360",
    "agent": "1",          # 返回代發(fā)價(jià)
    "sales_data": "1"      # 返回銷(xiāo)量數(shù)據(jù)
}

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

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

AI 選品：用大模型分析 價(jià)格/銷(xiāo)量/評(píng)分/競(jìng)爭(zhēng)度，自動(dòng)篩爆款

文案生成：基于 標(biāo)題+屬性+詳情圖，AI 生成電商標(biāo)題 / 賣(mài)點(diǎn) / 描述

價(jià)格監(jiān)控：定時(shí)調(diào)用，AI 預(yù)警價(jià)格波動(dòng) / 庫(kù)存不足

八、接入準(zhǔn)備（3 步搞定）

免費(fèi)測(cè)試

開(kāi)通權(quán)限：控制臺(tái) → 應(yīng)用管理 → 開(kāi)通 1688 item_get/item_detail

獲取 key/secret，領(lǐng)免費(fèi)測(cè)試額度，先測(cè)后買(mǎi)

?審核編輯 黃宇