唯品会搜索 - 西瓜猪开放平台

请求参数

Body 参数application/json

keyword

string

关键词

必需

page

integer

页码

必需

pageSize

integer

分页大小:默认20，最大100

必需

sort

string

排序

必需

排序方式:renqi-综合排序;price_asc 按价格升序;price_des按价格降序;total_sales_asc 按销量升序;total_sales_des; 按销量降序

sign

string

签名

必需

timeStamp

integer

秒级时间戳

必需

示例

{
  "keyword": "耳机",
  "page": 1,
  "pageSize": 10,
  "sort": "renqi",
   "sign": "70a8c1c51f67bda8c48ca95345266139",
  "timeStamp": 1740383544
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/vph/search' \
--header 'Content-Type: application/json' \
--data-raw '{
  "keyword": "耳机",
  "page": 1,
  "pageSize": 10,
  "sort": "renqi",
   "sign": "70a8c1c51f67bda8c48ca95345266139",
  "timeStamp": 1740383544
}'

返回响应

🟢200成功

application/json

Body

cache

boolean

必需

code

integer

必需

data

object

必需

goodsList

array [object {18}]

必需

message

string

必需

示例

{
    "cache": false,
    "code": 0,
    "data": {
        "goodsList": [
            {
                "itemid": "6920786814391466186",
                "itemtitle": "FreeBuds 4E 2024款 半入耳舒适佩戴蓝牙耳机",
                "itemdesc": null,
                "itemprice": "699",
                "itemsale": null,
                "itempic": "https://a.vpimg4.com/upload/merchandise/pdcvis/2024/03/01/5/f5d2809d-5e77-4025-940e-0092bc1e2f1d.jpg",
                "itemendprice": "359",
                "shoptype": null,
                "couponmoney": null,
                "couponstarttime": null,
                "couponendtime": null,
                "searchSource": "weipinhui",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/vphicon.png",
                "shopName": "唯品自营",
                "discount": "5.10",
                "fanli": "3.59",
                "tkrates": "1",
                "imgs": null
            },
            {
                "itemid": "6920554982748209046",
                "itemtitle": "AirPods Pro (第二代) USB-C 主动降噪耳机",
                "itemdesc": null,
                "itemprice": "1899",
                "itemsale": null,
                "itempic": "https://a.vpimg2.com/upload/merchandise/pdcvis/619937/2023/0915/167/3b13eb63-d1cf-4fed-868c-acfb261c9388.jpg",
                "itemendprice": "1709",
                "shoptype": null,
                "couponmoney": "190.00",
                "couponstarttime": "2025-02-24",
                "couponendtime": "2025-02-26",
                "searchSource": "weipinhui",
                "icon": "https://hxsh3.oss-cn-hangzhou.aliyuncs.com/diy/app/vphicon.png",
                "shopName": "唯品自营",
                "discount": "9.00",
                "fanli": "0.00",
                "tkrates": "0",
                "imgs": null
            }
        ]
    },
    "message": "操作成功"
}