唯品会商品列表与商品详情API接口
vip.item_search 关键字搜索商品
vip.item_get 获取指定商品详情数据
公共参数
| 名称 | 类型 | 必须 | 描述 |
|---|---|---|---|
| key | String | 是 | 调用key（必须以GET方式拼接在URL中） |
| secret | String | 是 | 调用密钥 |
| api_name | String | 是 | API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
| cache | String | 否 | [yes,no]默认yes，将调用缓存的数据，速度比较快 |
| result_type | String | 否 | [json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
| lang | String | 否 | [cn,en,ru]翻译语言，默认cn简体中文 |
| version | String | 否 | API版本 |
请求参数
请求参数：q=鞋子&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:
响应参数
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
item | item[] | 0 | 获取商品详情 | |
num_iid | String | 0 | 1710613157-6918711233889249157 | 商品ID |
title | String | 0 | 【清凉运动】森马夏季新款复古运动风男式休闲中裤短裤男 | 商品标题 |
desc_short | String | 0 | 商品简介 | |
price | Float | 0 | 35.00 | 价格 |
total_price | Float | 0 | ||
suggestive_price | Float | 0 | ||
orginal_price | Float | 0 | 159.00 | 原价 |
nick | String | 0 | 卖家昵称 | |
num | Int | 0 | 6 | |
min_num | Int | 0 | 0 | 最小量 |
detail_url | String | 0 | https://detail.vip.com/detail-1710613157-6918711233889249157.html | 商品链接 |
pic_url | String | 0 | https://a.vpimg4.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10.jpg | 商品图片 |
brand | String | 0 | 森马 | 品牌名称 |
brandId | Int | 0 | 1710613157 | 品牌ID |
rootCatId | Int | 0 | 顶级分类ID | |
cid | Int | 0 | 390576 | |
crumbs | Mix | 0 | 导航列表 | |
created_time | Int | 0 | 1537845115000 | |
modified_time | Int | 0 | 1683886534000 | |
delist_time | Int | 0 | 2145888000000 | |
desc | String | 0 | \u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2056028139-651972905622466560-651972905622466562-602.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/2103507544-651972905622466560-651972905622466562-603.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/805209464-651972905622466560-651972905622466562-604.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/965265007-651972905622466560-651972905622466562-605.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/1456204603-651972905622466560-651972905622466562-606.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/245784564-651972905622466560-651972905622466562-607.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/478942397-651972905622466560-651972905622466562-608.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/563202406-651972905622466560-651972905622466562-609.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/576808585-651972905622466560-651972905622466562-610.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/492548576-651972905622466560-651972905622466562-611.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/475079584-651972905622466560-651972905622466562-612.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/643984351-651972905622466560-651972905622466562-613.jpg\"\u003E\u003Cimg src=\"https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/723627373-651972905622466560-651972905622466562-614.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/353669547-651972905622466560-651972905622466562-615.jpg\"\u003E\u003Cimg src=\"https://a.vpimg2.com/upload/merchandise/pdcvop/00104218/10004116/241322868-651972905622466560-651972905622466562-616.jpg\"\u003E\u003Cimg src=\"https://a.vpimg3.com/upload/merchandise/pdcvop/00104218/10004116/270393169-651972905622466560-651972905622466562-617.jpg\"\u003E\u003Cimg src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.6719bcf88920c&p=3702633547&k=i_key&t=1729740025\" style=\"display:none\" /\u003E | 商品详情 |
desc_img | Mix | 0 | ["https://a.vpimg4.com/upload/merchandise/pdcvop/00104218/10004116/1540464613-651972905622466560-651972905622466562-601.jpg"] | 商品描述图片 |
item_imgs | Mix | 0 | [{"url": "https://a.vpimg2.com/upload/merchandise/pdcvis/104218/2020/0814/160/7932992b-c2f6-4ed2-a97b-69824fa7ba10_750x750_75.jpg"}] | 商品图片 |
item_weight | String | 0 | ||
item_size | String | 0 | ||
location | String | 0 | 发货地 | |
post_fee | Float | 0 | 物流费用 | |
express_fee | String | 0 | 快递费用 | |
ems_fee | String | 0 | EMS费用 | |
shipping_to | String | 0 | 发货至 | |
has_discount | String | 0 | ||
video | Mix | 0 | 商品视频 | |
is_virtual | String | 0 | ||
sample_id | String | 0 | 商品风格标识 | |
is_promotion | String | 0 | false | |
props_name | String | 0 | XL:黑色9000;M:黑色9000;XS:黑色9000;L:黑色9000;S:黑色9000;XXL:黑色9000;XXXL:黑色9000; | 商品属性名 |
prop_imgs | Mix | 0 | {"prop_img": []} | 商品属性图片列表 |
property_alias | String | 0 | 商品属性别名 | |
props | Mix | 0 | ||
total_sold | Int | 0 | 0 | |
skus | skus[] | 0 | 商品规格信息 | |
seller_id | Int | 0 | 卖家ID | |
sales | Int | 0 | 1 | 销量 |
shop_id | Int | 0 | 店铺ID | |
props_list | Mix | 0 | {"134:0": "颜色:黑色9000","453:0": "规格:XL","453:1": "规格:M","453:2": "规格:XS","453:3": "规格:L","453:4": "规格:S","453:5": "规格:XXL","453:6": "规格:XXXL"} | 商品属性 |
seller_info | seller_info[] | 0 | 卖家信息 | |
tmall | Mix | 0 | false | |
error | String | 0 | 错误信息 | |
warning | String | 0 | ||
url_log | Mix | 0 | ||
stuff_status | String | 0 | ||
data_from | String | 0 | ztk | |
method | String | 0 | ||
promo_type | String | 0 | null | |
props_img | Mix | 0 | ||
rate_grade | String | 0 | ||
priceRange | Mix | 0 | ||
shop_item | Mix | 0 | ||
relate_items | Mix | 0 | ||
shop_url | String | 0 | 店铺链接 | |
sn | String | 0 | 12B049261107-9000 |
