唯品会数据采集的 API 方案，我会从官方合规接口、第三方授权 API、调用规范和风险提示等方面，给你一份完整且可落地的指南，尤其适合新手快速上手。
一、官方 API 方案（企业级）
唯品会开放平台（VIP Open Platform）仅对企业合作伙伴开放 API 权限，个人开发者无法申请，核心数据接口主要面向入驻商家、供应链合作方等。
1.1 核心数据接口（评论 / 商品类）
| 接口名称 | 功能描述 | 权限要求 |
|---|---|---|
| comment.query | 获取商品评论列表（评分、内容、晒单、追评） | 店铺自有商品权限 |
| 获取商品基础信息（价格、库存、规格） | 基础开放权限 | |
| order.comment.get | 获取订单评价数据 | 店铺订单权限 |
1.2 官方 API 申请流程
- 企业认证：注册唯品会开放平台企业账号，完成企业营业执照、法人信息认证；
- 应用创建：在开放平台后台创建应用，填写应用名称、用途、回调地址（需 HTTPS 备案）；
- 权限申请：提交接口权限申请，需说明数据使用场景（如 “店铺运营分析”“商品口碑优化”），审核周期约 3-5 个工作日；
- 密钥获取：审核通过后，获取
AppKey、AppSecret和Access Token（有效期通常 30 天，需定期刷新）。
1.3 官方 API 调用示例（Python）
python
运行
import requests import time import hashlib import json def get_vip_sign(params, app_secret): """生成唯品会API签名（官方要求的签名算法）""" # 1. 按key升序排序参数 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接参数字符串 sign_str = app_secret for k, v in sorted_params: if v is not None and v != "": sign_str += f"{k}{v}" sign_str += app_secret # 3. MD5加密并转大写 sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() return sign def vip_comment_query(app_key, app_secret, access_token, product_id, page=1, page_size=20): """调用唯品会评论查询接口""" # 基础参数 params = { "appKey": app_key, "accessToken": access_token, "method": "comment.query", # 接口名称 "format": "json", "timestamp": str(int(time.time() * 1000)), # 时间戳（毫秒） "v": "1.0", # API版本 "productId": product_id, # 商品ID "page": page, "pageSize": page_size } # 生成签名 params["sign"] = get_vip_sign(params, app_secret) # 发送请求 url = "https://api.vip.com/router/rest" try: response = requests.post(url, data=params, timeout=10) result = response.json() if result.get("code") == 200: return result.get("data", {}) # 返回评论数据 else: print(f"接口调用失败：{result.get('msg')}") return {} except Exception as e: print(f"请求异常：{str(e)}") return {} # 调用示例（需替换为真实密钥和商品ID） if __name__ == "__main__": APP_KEY = "你的企业AppKey" APP_SECRET = "你的企业AppSecret" ACCESS_TOKEN = "你的访问令牌" PRODUCT_ID = "12345678" # 唯品会商品ID comments = vip_comment_query(APP_KEY, APP_SECRET, ACCESS_TOKEN, PRODUCT_ID) print(f"获取到{len(comments.get('comments', []))}条评论") # 打印第一条评论示例 if comments.get("comments"): first_comment = comments["comments"][0] print(f"用户昵称：{first_comment.get('nickname')}") print(f"评论内容：{first_comment.get('content')}") print(f"评分：{first_comment.get('score')}星")1.4 官方 API 限制
- 仅能获取自有店铺的商品 / 评论数据，无法获取竞品数据；
- 单接口 QPS 限制（通常 5-10 次 / 秒），单页最多 50 条评论，最多查询 100 页；
- 数据脱敏（隐藏用户完整昵称、手机号等隐私信息）。
二、第三方授权 API（个人 / 中小企业首选）
对于无法申请官方 API 的开发者，合规的第三方 API 服务商是最优选择，这类服务商通过唯品会授权合作获取数据，支持个人 / 企业使用，无需复杂资质。
2.1 主流第三方 API 服务商对比
| 服务商 | 核心接口 | 价格 | 特点 |
|---|---|---|---|
| 聚数塔 | vip.product.comment | 按量计费（0.1-0.5 元 / 100 条） | 支持商品评论、价格、库存采集，稳定率 99% |
| 数派科技 | vip.comment.get | 月套餐（99-999 元 / 月） | 含评论情感分析、晒单图片提取，多平台兼容 |
| 易观千帆 | vip.data.fetch | 定制化报价 | 企业级方案，含数据清洗、可视化报表 |
2.2 第三方 API 调用示例（以聚数塔为例）
python
运行
import requests def get_vip_comments_by_third(api_key, product_id, page=1, page_size=50): """ 调用第三方API获取唯品会商品评论 :param api_key: 第三方平台的API密钥 :param product_id: 唯品会商品ID :param page: 页码 :param page_size: 每页条数（最大50） :return: 评论列表 """ url = "https://api.jushuta.com/v1/vip/comment" headers = { "Authorization": f"ApiKey {api_key}", "Content-Type": "application/json" } params = { "product_id": product_id, "page": page, "page_size": page_size, "type": "all" # all:全部评论, good:好评, bad:差评 } try: resp = requests.get(url, headers=headers, params=params, timeout=15) if resp.status_code == 200: data = resp.json() if data["code"] == 0: return data["data"]["comments"] # 返回评论列表 else: print(f"第三方API错误：{data['msg']}") return [] else: print(f"HTTP请求失败：{resp.status_code}") return [] except Exception as e: print(f"请求异常：{str(e)}") return [] # 示例调用 if __name__ == "__main__": API_KEY = "你的第三方API密钥" # 注册后获取 PRODUCT_ID = "12345678" # 唯品会商品ID # 获取第一页50条全部评论 comments = get_vip_comments_by_third(API_KEY, PRODUCT_ID, page=1, page_size=50) # 遍历打印评论 for idx, comment in enumerate(comments[:5], 1): print(f"【{idx}】用户：{comment.get('nickname', '匿名')}") print(f"评分：{comment.get('score', 0)}星") print(f"评论：{comment.get('content', '无')}") print(f"晒单图片：{comment.get('images', [])}") print("-" * 50)2.3 第三方 API 优势
- 无需企业资质，个人开发者可快速注册使用；
- 支持任意商品数据采集（不限于自有店铺）；
- 提供完整数据（评论、晒图、追评、商品价格 / 库存）；
- 内置反风控机制，无需担心 IP 封禁、请求限制。
三、合规性与风险提示（必看）
- 合法采集前提：
- 严禁通过爬虫、逆向接口等非授权方式采集唯品会数据（唯品会反爬机制严格，IP / 账号易被封禁，且涉嫌违法）；
- 仅使用官方或授权第三方 API，数据用途仅限内部分析、商业决策，不得售卖、泄露用户隐私。
- 数据使用规范：
- 对采集的用户信息（昵称、手机号、地址等）进行脱敏处理；
- 遵守《个人信息保护法》《电子商务法》，不得用于非法用途。
- 技术风险规避：
- 第三方 API 需选择正规服务商（查看营业执照、合作授权证明）；
- 调用接口时添加异常处理（超时重试、错误捕获），避免程序崩溃。
四、总结
- 企业店铺自用：优先选择唯品会官方 API，合规性最高，数据最权威；
- 个人 / 竞品分析：选择正规第三方 API（如聚数塔、数派科技），低成本、易上手；
- 核心原则：无论哪种方式，必须保证数据采集和使用的合规性，避免法律风险。
如果需要，我可以提供：
- 第三方 API 注册 & 密钥获取的详细步骤；
- 多页评论自动遍历的完整代码（含分页、重试、数据保存）；
- 评论数据清洗 / 分析的示例代码（如情感分析、关键词提取）。
