VVIC关键词搜索API技术实现

Ace_31750887762025-06-20 10:53

接口概述

VVIC平台提供商品关键词搜索接口，支持通过HTTP GET/POST请求获取匹配商品列表。该接口主要服务于第三方开发者，需申请API Key后方可使用。

基础参数

参数名类型必填说明keywordstring是搜索关键词(UTF-8编码)pageint否分页页码(默认1)sizeint否每页数量(默认20)sortstring否排序方式(newest/price_asc/price_desc)

点击获取key和secret

Python代码示例

python 复制代码

import requests
import hashlib
import time

API_URL = "https://api.vvic.com/search/v1/by_keyword"
API_KEY = "your_api_key_here"

def generate_sign(params, secret):
    param_str = '&'.join([f'{k}={v}' for k,v in sorted(params.items())])
    return hashlib.md5((param_str + secret).encode()).hexdigest()

def search_items(keyword, page=1, size=20):
    params = {
        "keyword": keyword,
        "page": page,
        "size": size,
        "timestamp": int(time.time())
    }
    params["sign"] = generate_sign(params, API_KEY)
    
    try:
        response = requests.get(API_URL, params=params)
        return response.json()
    except Exception as e:
        print(f"API请求失败: {str(e)}")
        return None

# 调用示例
result = search_items("连衣裙", sort="price_asc")
print(result)

返回数据结构

css 复制代码

{
  "code": 200,
  "data": {
    "total": 1250,
    "items": [
      {
        "item_id": "123456",
        "title": "2025新款夏季连衣裙",
        "price": 89.9,
        "cover_img": "https://img.vvic.com/...jpg",
        "shop_id": "8888"
      }
    ]
  }
}

错误代码

代码说明400参数缺失或格式错误401API密钥无效429请求频率超限500服务端错误