唯品会商品列表 API 全解析：从搜索条件到分页查询的实战指南

一、前言

唯品会开放平台提供商品列表 API 接口，支持通过关键词、分类等参数获取商品数据，适用于市场调研、竞品分析等场景。

二、接口概述

1.核心功能

支持按关键词（keyword）、分类 ID（cat）、价格范围（start_price/end_price）筛选商品。分页参数：page（页码）、page_size（每页数量，默认 20）。

排序方式：通过 sort 参数指定（如按价格、销量等）。

2.认证机制

使用 AppKey 和 AppSecret 生成签名（MD5 加密），需包含 timestamp、sign_method 等公共参数。

公共请求地址：c0b.cc/R4rbK2。

3.响应格式

JSON 结构，包含商品 ID、名称、价格、主图 URL 等字段。

三、Python 请求示例

以下代码演示如何调用商品列表 API 并处理返回数据：

python

# coding:utf-8

""" Compatible for python2.x and python3.x requirement: pip install requests """

from __future__ import print_function import requests

# 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 "

app_key = "YOUR_APP_KEY" q = "衣服" # 目标关键词

# 请求示例 url 默认请求参数已经做 URL 编码 url = "vip/item_search/?key=<您自己的 apiKey>&q=女装 &page="

headers = { "Accept-Encoding": "gzip", "Connection": "close" } if __name__ == "__main__": r = requests.get(url, headers=headers) json_obj = r.json() print(json_obj)

代码说明：

1.签名生成：按唯品会 API 规范对参数排序后拼接并 MD5 加密。

2.请求处理：包含公共参数（app_key、timestamp 等）和业务参数（keyword、page 等）。

3.错误处理：捕获网络异常并检查响应状态码。