一、接口核心能力（B2B 專屬）

覆蓋 1688 全類型商品：一件代發(fā)、批發(fā)、實力商家、工廠直營、跨境貨源

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

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

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

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

接口名稱：1688.item_get（1688 商品詳情）

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

請求方式：GET / POST（推薦 POST）

返回格式：JSON

必傳參數(shù)

表格

常用可選參數(shù)

cache：yes/no（默認 yes，緩存加速）

lang：默認 zh-CN

result_type：json/jsonu（默認 json）

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

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

num_iid：商品 ID

title：商品標題（完整標題）

pic_url：商品主圖

images：輪播圖列表（多圖）

desc_img：詳情頁圖片列表（無水?。?/p>

video_url：商品主視頻（如有）

cid：類目 ID、類目名稱

brand：品牌信息

2）B2B 價格體系（核心）

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

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

agent_price：一件代發(fā)專屬價

min_num：最小起批量（MOQ）

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

mix_price：混批價格

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

sku：完整 SKU 列表（顏色、尺碼、規(guī)格、對應價格、庫存、貨號）

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

stock：總庫存、SKU 級實時庫存

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

sales：30 天銷量、總銷量

seller_name：店鋪名稱

seller_type：店鋪類型（實力商家、工廠、普通商家）

credit_level：誠信通年限、交易等級、好評率

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

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

5）詳情描述

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

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

python

運行

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"標題：{item.get('title')}")
            print(f"代發(fā)價：{item.get('agent_price')} 批發(fā)價：{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')}（誠信通：{item.get('credit_level')}）")
            
            # 輸出SKU規(guī)格
            skus = item.get("sku", [])
            print(f"nSKU規(guī)格（共{len(skus)}個）：")
            for sku in skus:
                print(f"- {sku.get('properties_name')} | 價格：{sku.get('price')} | 庫存：{sku.get('quantity')}")
            
            return item
        else:
            print(f"請求失?。簕result.get('msg')}，錯誤碼：{result.get('code')}")
            return None
    except Exception as e:
        print(f"請求異常：{e}")
        return None

if __name__ == "__main__":
    get_1688_item_detail()

五、高頻電商場景落地

無貨源跨平臺鋪貨（效率核心）抓取 1688 代發(fā)商品 → 提取標題、主圖、詳情、SKU、代發(fā)價 → 一鍵上架到淘寶、拼多多、抖音、小紅書、Temu，自動計算利潤空間。

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

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

價格 & 庫存監(jiān)控定時調(diào)用接口，監(jiān)控批發(fā)價、代發(fā)價、庫存、銷量變化，自動預警超賣 / 漲價。

審核編輯 黃宇