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

​

一、核心前提：开通万邦账号，拿到 key/secret

注册万邦（Onebound）账号：访问 open.onebound.cn 注册、实名认证、开通淘宝商品详情 API 权限（item_get/item_detail）

获取密钥：控制台 → 应用管理 → 拿到你的 key 和 secret（这两个是调用必须凭证，保密）

测试额度：先领免费测试额度，验证通了再买正式套餐

二、接口选择（淘宝详情）

基础版：taobao.item_get（获取标题、价格、主图、SKU、详情图、店铺等核心字段）

通用统一版：item_detail（跨平台统一入口，自动识别淘宝，和 1688 / 京东 / 小红书同套参数）

高级版：taobao.item_get_pro（含更多扩展字段、历史价格、属性图等）

统一请求地址（推荐通用 item_detail）

plaintext

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

淘宝专用地址（item_get）

plaintext

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

三、必传请求参数（二选一，最简单用 url）

表格

参数	必填	说明
key	是	你的万邦 API Key
secret	是	你的万邦 API Secret
api_name	是	固定：item_detail 或 item_get
url	二选一	淘宝商品完整链接（自动解析 num_iid，推荐）
num_iid	二选一	淘宝商品 ID（数字串，如 784567890123）
platform	否	手动指定：taobao（不传自动识别）
cache	否	yes/no，默认 yes（缓存更快）

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

python

运行

import requests

# 1. 替换成你的万邦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("✅ 商品标题:", item.get("title"))
            print("✅ 售价:", item.get("price"))
            print("✅ 原价:", item.get("market_price"))
            print("✅ 主图:", item.get("pic_url"))
            print("✅ 销量:", item.get("sales"))
            print("✅ SKU数量:", 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("请求异常:", e)
        return None

if __name__ == "__main__":
    get_taobao_detail()

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

json

{
  "code": 200,
  "result": {
    "num_iid": "784567890123",       // 商品ID
    "title": "商品完整标题",
    "price": "199.00",               // 售价
    "market_price": "299.00",         // 原价
    "pic_url": "https://xxx.jpg",     // 主图
    "images": ["图1","图2","图3"],    // 轮播图
    "desc_img": ["详情图1","图2"],    // 详情页图片
    "sales": "12345",                 // 销量
    "stock": "999",                   // 库存
    "sku": [                          // SKU规格（颜色、尺码、价格、库存）
      {"spec": "颜色:红色;尺码:L", "price": "199", "stock": "100"}
    ],
    "goods_attr": "品牌:XX;材质:棉...", // 规格参数
    "shop_name": "XX旗舰店",
    "seller_id": "12345678",
    "detail_url": "原商品链接"
  }
}

六、常见问题与避坑

401/403 鉴权失败：检查 key/secret 是否正确、是否开通淘宝权限、是否过期 / 欠费

返回空 / 无数据：确认商品链接 /num_iid 正确、商品未下架、平台未风控

调用频率限制：按套餐 QPS / 日限控制，不要并发过高，加重试 / 队列

数据不全：基础版item_get够用，要更全字段用item_get_pro

七、快速测试（不用写代码）

直接在浏览器 / Postman 拼链接测试：

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

要不要我给你整理一份万邦淘宝 item_detail 的完整字段清单 + Postman 导入配置，直接导入就能一键测试？

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

下面给你一份万邦（龙虾 / Onebound）1688 通用商品详情接口 item_detail /item_get 的完整详解，从接口定位、地址、参数、返回字段、调用示例到 AI 场景用法，一次性讲全，直接可用。

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

万邦提供两套 1688 详情接口：

通用统一入口（推荐）

接口名：item_detail

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

特点：跨平台统一参数，自动识别 1688 / 淘宝 / 京东，一套代码跑全平台

1688 专用入口

接口名：1688.item_get

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

特点：1688 字段最全，B2B 批发属性（起批量、阶梯价、代发价）完整

下文以 通用 item_detail 为主，同时标注 1688 专用差异。

二、核心功能（AI 场景价值）

一键获取 1688 商品全量结构化数据（50 + 字段）

B2B 专属：起批量 MOQ、阶梯价、分销代发价、定制属性

AI 适配：数据干净、结构化，可直接喂给大模型做选品分析、标题生成、文案提炼、价格预测

三、请求地址与公共参数

1）通用 item_detail（跨平台）

plaintext

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

2）1688 专用 item_get

plaintext

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

3）公共必传参数（所有接口通用）

表格

参数	类型	必填	说明
key	String	✅	你的万邦 API Key
secret	String	✅	你的万邦 API Secret
api_name	String	✅	固定：item_detail 或 1688.item_get
url	String	二选一	1688 商品完整链接（自动解析 num_iid，推荐）
num_iid	String	二选一	1688 商品 ID（数字串，如 610947572360）
platform	String	❌	手动指定：1688（不传自动识别）
cache	String	❌	yes/no，默认 yes（缓存加速）
lang	String	❌	cn/en/ru，默认 cn（多语言翻译）

四、1688 特有参数（专用 item_get）

表格

参数	说明
sales_data=1	返回近 30 天成交数据（销量、交易额）
agent=1	返回分销代发价（1688 一件代发专属）
sku_detail=1	返回完整 SKU 规格（颜色 / 尺寸 / 价格 / 库存 / 编码）

五、返回数据结构（核心字段全解）

成功响应（code=200）

json

{
  "code": 200,
  "msg": "success",
  "result": {
    "num_iid": "610947572360",       // 商品ID
    "title": "2026新款夏季纯棉T恤女 宽松大码百搭上衣 工厂批发", // 标题
    "price": "35.00",                 // 批发参考价
    "market_price": "89.00",           // 专柜价/原价
    "min_order": "2",                  // 起批量 MOQ（B2B核心）
    "pic_url": "https://g.alicdn.com/xxx.jpg", // 主图
    "images": ["图1","图2","图3"],    // 轮播图（5-8张）
    "desc_img": ["详情图1","图2"],    // 详情页长图
    "sales": "12500",                 // 总销量
    "month_sales": "3200",            // 月销量（近30天）
    "stock": "9999",                   // 总库存
    "sku": [                           // SKU列表（规格+价格+库存）
      {
        "spec": "颜色:白色;尺码:M",
        "price": "35.00",
        "stock": "1200",
        "sku_id": "123456789"
      }
    ],
    "price_range": [                   // 阶梯价（B2B核心）
      {"min_num": "2", "price": "35.00"},
      {"min_num": "10", "price": "32.00"},
      {"min_num": "50", "price": "29.00"}
    ],
    "agent_price": "33.00",            // 代发价（agent=1时返回）
    "goods_attr": {                    // 商品属性（材质/尺码/品牌）
      "品牌": "自主",
      "材质": "纯棉",
      "尺码": "M/L/XL/XXL"
    },
    "shop_name": "XX服饰工厂店",
    "shop_id": "12345678",
    "credit_score": "4.9",             // 店铺评分
    "detail_url": "https://detail.1688.com/offer/610947572360.html"
  }
}

失败响应（常见错误码）

401：key/secret 错误或权限未开通

403：频率超限或余额不足

404：商品不存在 / 已下架

500：接口内部异常（重试即可）

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

1）通用 item_detail（推荐）

python

运行

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("标题:", item["title"])
        print("批发价:", item["price"])
        print("起批量:", item["min_order"])
        print("月销量:", item["month_sales"])
        return item
    else:
        print("失败:", data["msg"])
        return None

get_1688_detail()

2）1688 专用 item_get（含代发价）

python

运行

params = {
    "key": API_KEY,
    "secret": API_SECRET,
    "api_name": "1688.item_get",
    "num_iid": "610947572360",
    "agent": "1",          # 返回代发价
    "sales_data": "1"      # 返回销量数据
}

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

批量采集：多线程调用，一次拿 100+ 商品结构化数据

AI 选品：用大模型分析 价格/销量/评分/竞争度，自动筛爆款

文案生成：基于 标题+属性+详情图，AI 生成电商标题 / 卖点 / 描述

价格监控：定时调用，AI 预警价格波动 / 库存不足

八、接入准备（3 步搞定）

免费测试

开通权限：控制台 → 应用管理 → 开通 1688 item_get/item_detail

获取 key/secret，领免费测试额度，先测后买

​审核编辑 黄宇