电商效率翻倍：对接 1688 详情接口，商品全量信息一键抓取

一、接口核心能力（B2B 专属）

覆盖 1688 全类型商品：一件代发、批发、实力商家、工厂直营、跨境货源

一次返回50 + 核心字段，含 B2B 专属数据：阶梯价、MOQ (最小起订量)、混批规则、代发价、诚信通、实力商家认证

免商家授权、免登录、免处理 1688 加密签名，直接 HTTP 调用

高并发稳定，支持批量采集、店群 / ERP 系统对接

二、接口基础信息

接口名称：1688.item_get（1688 商品详情）

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

请求方式：GET / POST（推荐 POST）

返回格式：JSON

必传参数

表格

参数名	必填	说明
key	是	Open Claw 调用 Key
secret	是	接口密钥
api_name	是	固定值：item_get
num_iid	是	1688 商品 ID（链接中纯数字串，如 678901234567）

常用可选参数

cache：yes/no（默认 yes，缓存加速）

lang：默认 zh-CN

result_type：json/jsonu（默认 json）

三、返回核心全量字段（铺货 / 选品直接用）

1）商品基础信息

num_iid：商品 ID

title：商品标题（完整标题）

pic_url：商品主图

images：轮播图列表（多图）

desc_img：详情页图片列表（无水印）

video_url：商品主视频（如有）

cid：类目 ID、类目名称

brand：品牌信息

2）B2B 价格体系（核心）

price：零售价 / 代发价

batch_price：批发价（阶梯）

agent_price：一件代发专属价

min_num：最小起批量（MOQ）

price_range：价格区间（如 1-5 件 / 5-10 件）

mix_price：混批价格

3）SKU 规格 & 库存

sku：完整 SKU 列表（颜色、尺码、规格、对应价格、库存、货号）

sku_properties_name：规格属性名（如颜色：红色；尺码：L）

stock：总库存、SKU 级实时库存

4）交易 & 商家资质（选品风控）

sales：30 天销量、总销量

seller_name：店铺名称

seller_type：店铺类型（实力商家、工厂、普通商家）

credit_level：诚信通年限、交易等级、好评率

delivery_place：发货地、发货时效

support_agent：是否支持一件代发

5）详情描述

desc：商品详情文案、参数、材质、售后说明

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

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"]
            # 打印核心选品数据
            print("=== 1688商品全量信息 ===")
            print(f"商品ID：{item.get('num_iid')}")
            print(f"标题：{item.get('title')}")
            print(f"代发价：{item.get('agent_price')} 批发价：{item.get('batch_price')}")
            print(f"最小起批量：{item.get('min_num')}")
            print(f"主图：{item.get('pic_url')}")
            print(f"发货地：{item.get('delivery_place')}")
            print(f"商家：{item.get('seller_name')}（诚信通：{item.get('credit_level')}）")
            
            # 输出SKU规格
            skus = item.get("sku", [])
            print(f"nSKU规格（共{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 代发商品 → 提取标题、主图、详情、SKU、代发价 → 一键上架到淘宝、拼多多、抖音、小红书、Temu，自动计算利润空间。

货源选品 & 比价批量抓取 1688 商品，对比代发价、起批量、商家资质、发货时效，筛选优质一件代发货源，规避低质商家。

商品素材批量采集一键导出主图、详情图、SKU 图、视频，自动去水印、整理，无需手动截图 / 下载。

价格 & 库存监控定时调用接口，监控批发价、代发价、库存、销量变化，自动预警超卖 / 涨价。

审核编辑 黄宇