唯品会商品详情 API（item_get）接入教程｜一键获取商品 / 价格 / SKU / 图片

唯品会商品详情 API 接入完整教程（Python 可直接运行）

在开发比价工具、商品采集、分销商城、价格监控、电商数据分析等项目时，唯品会商品数据是非常重要的一环。本文基于标准开放 API 接口，教你从零接入唯品会 item_get 商品详情 API，无需爬虫、不封 IP、稳定高效，支持商品标题、价格、原价、图片、SKU、库存、品牌、详情图等全字段获取。

一、接口能做什么？

• 根据商品 ID 获取唯品会商品完整详情
• 获取现价、原价、促销价
• 获取商品主图、详情图、SKU 图片
• 获取商品规格、SKU 列表、库存
• 获取品牌、分类、店铺信息
• 获取商品链接、上架时间、下架时间

适合：

• 电商比价小程序 / 网站
• 商品数据分析、选品工具
• 店铺商品一键搬家
• 价格监控、大促分析
• 毕业设计 / 课程设计

二、接口基本信息

• 接口名称：item_get（获取商品详情）
• 请求方式：GET/POST
• 返回格式：JSON
• 编码：UTF-8
• 必备参数：商品 ID（num_iid）、key、secret

三、公共参数（所有接口通用）

表格

四、请求参数（唯品会专用）

表格

示例：

plaintext

num_iid=1710613157-6918711233889249157

五、响应核心字段说明

开发最常用字段：

• num_iid：商品 ID
• title：商品标题
• price：现价
• orginal_price：原价
• pic_url：商品主图
• detail_url：商品详情页
• brand：品牌名称
• desc：商品详情（带图片）
• desc_img：详情图片列表
• skus：商品规格（颜色、尺码等）
• quantity：库存数量
• shop_name：店铺名称

六、Python 完整调用代码（复制即用）

python

运行

import requests

# ===================== 配置信息（改成你自己的） =====================
API_KEY = "你的API_KEY"
API_SECRET = "你的API_SECRET"
API_URL = "https://api-gw.xxx.cn/vip/item_get"
# ====================================================================

def get_vip_item_detail(num_iid):
    """
    获取唯品会商品详情
    :param num_iid: 商品ID（店铺ID-商品ID）
    :return: 商品详情JSON
    """
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "api_name": "item_get",
        "num_iid": num_iid,
        "cache": "yes",
        "result_type": "json",
        "lang": "cn"
    }

    try:
        resp = requests.get(API_URL, params=params, timeout=10)
        return resp.json()
    except Exception as e:
        print("请求异常：", e)
        return None

def parse_item_data(data):
    """解析商品核心信息"""
    if not data or data.get("error_code") != "0000":
        return {"status": 0, "msg": data.get("reason", "获取失败")}

    item = data.get("item", {})
    return {
        "status": 1,
        "商品ID": item.get("num_iid"),
        "商品标题": item.get("title"),
        "现价": item.get("price"),
        "原价": item.get("orginal_price"),
        "商品图片": item.get("pic_url"),
        "商品链接": item.get("detail_url"),
        "品牌": item.get("brand"),
        "店铺": item.get("seller_info", {}).get("shop_name", "未知"),
        "SKU数量": len(item.get("skus", {}).get("sku", []))
    }

# ===================== 测试调用 =====================
if __name__ == "__main__":
    # 唯品会商品ID
    iid = "1710613157-6918711233889249157"
    res = get_vip_item_detail(iid)
    result = parse_item_data(res)

    for k, v in result.items():
        print(f"{k}：{v}")

七、返回示例（成功）

json

{
  "item": {
    "num_iid": "1710613157-6918711233889249157",
    "title": "【清凉运动】森马夏季新款复古运动风男式休闲中裤短裤男",
    "price": "35.00",
    "orginal_price": "159.00",
    "pic_url": "https://a.vpimg4.com/upload/merchandise/pdcvis/xxx.jpg",
    "detail_url": "https://detail.vip.com/detail-xxx.html",
    "brand": "森马",
    "shop_name": "唯品自营",
    "skus": {
      "sku": [
        {
          "price": "35",
          "orginal_price": "159",
          "properties_name": "颜色:黑色;规格:XL",
          "quantity": 1
        }
      ]
    }
  },
  "error_code": "0000"
}

八、常见错误码与解决

表格

九、接入注意事项（必看）

1. 商品 ID 必须是 店铺 ID - 商品 ID 格式，不能只传数字。
2. 请求不要过快，建议间隔1~3 秒，避免触发限流。
3. 开启cache=yes速度更快，适合频繁查询。
4. 商品下架会返回2000错误，属于正常情况。
5. 不要用于违规用途，仅用于合法开发与学习。

十、可扩展的实用功能

• 批量获取商品详情，生成 Excel 报表
• 价格监控：低于指定价自动提醒
• 商品图片 / 详情一键采集
• 跨平台（淘宝 / 京东 / 唯品会）比价系统
• 大促价格实时监控

十一、总结

唯品会 item_get 接口是电商开发必备接口，接入简单、数据稳定、字段齐全，不用写爬虫、不用处理反爬，非常适合快速开发比价、选品、数据分析类项目。