唯品会平台关键字搜索接口接入指南与代码示例

本文链接：https://blog.csdn.net/2503_90284255/article/details/146396658

接口概述

接口功能‌：通过关键词获取唯品会平台商品搜索结果，支持分页、排序、筛选等参数。
适用场景‌：电商比价工具、商品数据分析、第三方导购平台等。

接口基本信息
请求URL
plaintext
Copy Code
https://api.vip.com/search (示例URL，实际需参考官方文档)

请求方式

GET 或 POST

请求参数
参数名   类型   必填   说明
keyword   string   是   搜索关键词（如“连衣裙”）
page_no   int   否   页码，默认1
page_size   int   否   每页数量，默认20，最大100
sort_type   string   否   排序方式（price_asc/price_desc）
access_token   string   是   授权令牌（需申请API权限）
代码示例（Python）
python
Copy Code
import requests

def search_vip_keyword(keyword, page=1, page_size=20):
    url = "https://api.vip.com/search"
    headers = {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    }
    params = {
        "keyword": keyword,
        "page_no": page,
        "page_size": page_size,
        "sort_type": "price_asc"
    }

    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status() # 检查HTTP错误
        data = response.json()

        if data["code"] == 200:
            return data["result"]
        else:
            print(f"搜索失败: {data['message']}")
            return None
    except requests.exceptions.RequestException as e:
        print(f"请求异常: {e}")
        return None

# 调用示例
results = search_vip_keyword("运动鞋", page=1, page_size=10)
if results:
for product in results["products"]:
print(f"商品ID: {product['id']}, 标题: {product['title']}, 价格: {product['price']}")

响应数据结构（示例）
json
Copy Code
{
"code": 200,
"message": "success",
"result": {
    "total": 1500,
    "products": [
      {
        "id": "123456",
        "title": "秋季新款运动鞋男透气",
        "price": 299.00,
        "brand": "Nike",
        "image_url": "https://example.com/image.jpg",
        "product_url": "https://vip.com/product/123456"
      }
    ]
}
}