一、接口核心能力（B2B 專(zhuān)屬）

覆蓋 1688 全類(lèi)型商品：一件代發(fā)、批發(fā)、實(shí)力商家、工廠(chǎng)直營(yíng)、跨境貨源

一次返回50 + 核心字段，含 B2B 專(zhuān)屬數(shù)據(jù)：階梯價(jià)、MOQ (最小起訂量)、混批規(guī)則、代發(fā)價(jià)、誠(chéng)信通、實(shí)力商家認(rèn)證

免商家授權(quán)、免登錄、免處理 1688 加密簽名，直接 HTTP 調(diào)用

高并發(fā)穩(wěn)定，支持批量采集、店群 / ERP 系統(tǒng)對(duì)接

二、接口基礎(chǔ)信息

接口名稱(chēng)：1688.item_get（1688 商品詳情）

請(qǐng)求地址：https://api-gw.onebound.cn/1688/item_get

請(qǐng)求方式：GET / POST（推薦 POST）

返回格式：JSON

必傳參數(shù)

表格

常用可選參數(shù)

cache：yes/no（默認(rèn) yes，緩存加速）

lang：默認(rèn) zh-CN

result_type：json/jsonu（默認(rèn) json）

三、返回核心全量字段（鋪貨 / 選品直接用）

1）商品基礎(chǔ)信息

num_iid：商品 ID

title：商品標(biāo)題（完整標(biāo)題）

pic_url：商品主圖

images：輪播圖列表（多圖）

desc_img：詳情頁(yè)圖片列表（無(wú)水?。?/p>

video_url：商品主視頻（如有）

cid：類(lèi)目 ID、類(lèi)目名稱(chēng)

brand：品牌信息

2）B2B 價(jià)格體系（核心）

price：零售價(jià) / 代發(fā)價(jià)

batch_price：批發(fā)價(jià)（階梯）

agent_price：一件代發(fā)專(zhuān)屬價(jià)

min_num：最小起批量（MOQ）

price_range：價(jià)格區(qū)間（如 1-5 件 / 5-10 件）

mix_price：混批價(jià)格

3）SKU 規(guī)格 & 庫(kù)存

sku：完整 SKU 列表（顏色、尺碼、規(guī)格、對(duì)應(yīng)價(jià)格、庫(kù)存、貨號(hào)）

sku_properties_name：規(guī)格屬性名（如顏色：紅色；尺碼：L）

stock：總庫(kù)存、SKU 級(jí)實(shí)時(shí)庫(kù)存

4）交易 & 商家資質(zhì)（選品風(fēng)控）

sales：30 天銷(xiāo)量、總銷(xiāo)量

seller_name：店鋪名稱(chēng)

seller_type：店鋪類(lèi)型（實(shí)力商家、工廠(chǎng)、普通商家）

credit_level：誠(chéng)信通年限、交易等級(jí)、好評(píng)率

delivery_place：發(fā)貨地、發(fā)貨時(shí)效

support_agent：是否支持一件代發(fā)

5）詳情描述

desc：商品詳情文案、參數(shù)、材質(zhì)、售后說(shuō)明

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

python

運(yùn)行

import requests

# 替換為你的Open Claw Key & Secret
API_KEY = "你的key"
API_SECRET = "你的secret"

# 1688商品ID（從商品鏈接提取，如https://detail.1688.com/offer/678901234567.html）
NUM_IID = "678901234567"

def get_1688_item_detail():
    url = "https://api-gw.onebound.cn/1688/item_get"
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_get",
        "num_iid": NUM_IID
    }

    try:
        resp = requests.get(url, params=params, timeout=20)
        result = resp.json()

        if result.get("code") == 200:
            item = result["result"]
            # 打印核心選品數(shù)據(jù)
            print("=== 1688商品全量信息 ===")
            print(f"商品ID：{item.get('num_iid')}")
            print(f"標(biāo)題：{item.get('title')}")
            print(f"代發(fā)價(jià)：{item.get('agent_price')} 批發(fā)價(jià)：{item.get('batch_price')}")
            print(f"最小起批量：{item.get('min_num')}")
            print(f"主圖：{item.get('pic_url')}")
            print(f"發(fā)貨地：{item.get('delivery_place')}")
            print(f"商家：{item.get('seller_name')}（誠(chéng)信通：{item.get('credit_level')}）")
            
            # 輸出SKU規(guī)格
            skus = item.get("sku", [])
            print(f"nSKU規(guī)格（共{len(skus)}個(gè)）：")
            for sku in skus:
                print(f"- {sku.get('properties_name')} | 價(jià)格：{sku.get('price')} | 庫(kù)存：{sku.get('quantity')}")
            
            return item
        else:
            print(f"請(qǐng)求失?。簕result.get('msg')}，錯(cuò)誤碼：{result.get('code')}")
            return None
    except Exception as e:
        print(f"請(qǐng)求異常：{e}")
        return None

if __name__ == "__main__":
    get_1688_item_detail()

五、高頻電商場(chǎng)景落地

無(wú)貨源跨平臺(tái)鋪貨（效率核心）抓取 1688 代發(fā)商品 → 提取標(biāo)題、主圖、詳情、SKU、代發(fā)價(jià) → 一鍵上架到淘寶、拼多多、抖音、小紅書(shū)、Temu，自動(dòng)計(jì)算利潤(rùn)空間。

貨源選品 & 比價(jià)批量抓取 1688 商品，對(duì)比代發(fā)價(jià)、起批量、商家資質(zhì)、發(fā)貨時(shí)效，篩選優(yōu)質(zhì)一件代發(fā)貨源，規(guī)避低質(zhì)商家。

商品素材批量采集一鍵導(dǎo)出主圖、詳情圖、SKU 圖、視頻，自動(dòng)去水印、整理，無(wú)需手動(dòng)截圖 / 下載。

價(jià)格 & 庫(kù)存監(jiān)控定時(shí)調(diào)用接口，監(jiān)控批發(fā)價(jià)、代發(fā)價(jià)、庫(kù)存、銷(xiāo)量變化，自動(dòng)預(yù)警超賣(mài) / 漲價(jià)。

審核編輯 黃宇