唯品会平台商品搜索接口开发指南（Python实现）

本文将介绍如何通过Python调用唯品会开放平台的商品搜索接口，实现关键字搜索功能。接口说明

唯品会开放平台提供了商品搜索API，开发者可以通过发送HTTP请求获取商品列表数据。主要参数包括：

bash 复制代码

keyword：搜索关键词
page：分页页码
pageSize：每页数量
sort：排序方式

准备工作

less 复制代码

注册唯品会开放平台开发者账号
创建应用获取App [Key和App Secret](https://o0b.cn/iiiace)
申请商品搜索API权限

Python实现代码

import requests import hashlib import time import json

class VipSearchAPI: def init (self, app_key, app_secret): self.app_key = app_key self.app_secret = app_secret self.base_url = "openapi.vip.com"

python 复制代码

def _generate_sign(self, params):
    """生成签名"""
    param_str = "".join([f"{k}{v}" for k, v in sorted(params.items())])
    sign_str = f"{self.app_secret}{param_str}{self.app_secret}"
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper()

def search_products(self, keyword, page=1, page_size=20, sort=0):
    """商品搜索接口"""
    timestamp = str(int(time.time() * 1000))
    params = {
        "method": "vip.products.search",
        "appKey": self.app_key,
        "timestamp": timestamp,
        "keyword": keyword,
        "page": page,
        "pageSize": page_size,
        "sort": sort,
        "format": "json"
    }
    
    params["sign"] = self._generate_sign(params)
    
    try:
        response = requests.get(f"{self.base_url}/router/rest", params=params)
        response.raise_for_status()
        return response.json()
    except Exception as e:
        print(f"API请求失败: {e}")
        return None

使用示例

if name == "main": # 替换为你的App Key和App Secret api = VipSearchAPI("your_app_key", "your_app_secret") result = api.search_products("女装", page=1, page_size=10) print(json.dumps(result, indent=2, ensure_ascii=False))

vip_search.py

已完成代码说明

javascript 复制代码

VipSearchAPI类封装了唯品会搜索接口的核心功能
_generate_sign方法用于生成API请求所需的签名
search_products方法实现商品搜索功能，支持分页和排序
返回结果为JSON格式，包含商品列表和相关信息

常见问题

复制代码

签名错误：检查App Secret是否正确，参数排序是否符合要求
权限不足：确认已申请商品搜索API权限
请求频率限制：唯品会API有调用频率限制，建议合理控制请求间隔

总结

通过唯品会开放平台API，开发者可以方便地实现商品搜索功能。本文提供的Python代码示例可直接集成到电商比价、数据分析等应用中。实际使用时请替换为真实的App Key和App Secret，并根据业务需求调整参数。