唯品会商品列表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.错误处理：捕获网络异常并检查响应状态码。