V兔API开放平台

名称	类型	必须	示例值	描述
shop_id	String	true		店铺 ID
fields	String	true	pic_url,num,props,valid_thru	需返回的字段列表。可选值为 Item 商品结构体中的以下字段： approve_status,num_iid,title,nick,type,cid,pic_url,num,props,valid_thru, list_time,price,has_discount,has_invoice,has_warranty,has_showcase, modified,delist_time,postage_id,seller_cids,outer_id；字段之间用“,”分隔。不支持其他字段，如果需要获取其他字段数据，调用 taobao.item.seller.get。
q	String	false	nike	搜索字段。搜索商品的 title。
banner	String	false	for_shelved	分类字段。可选值：regular_shelved(定时上架)never_on_shelf(从未上架)off_shelf(我下架的)for_shelved(等待所有上架)sold_out(全部卖完)violation_off_shelf(违规下架的)默认查询 for_shelved(等待所有上架)这个状态的商品注：for_shelved(等待所有上架)=regular_shelved(定时上架)+never_on_shelf(从未上架)+off_shelf(我下架的)
cid	Number	false	1232	商品类目 ID。ItemCat 中的 cid 字段。可以通过 taobao.itemcats.get 取到
seller_cids	String	false	12,123	卖家店铺内自定义类目 ID。多个之间用“,”分隔。可以根据 taobao.sellercats.list.get 获得。(注：目前最多支持 32 个 ID 号传入)
page_no	Number	false	2	页码。取值范围：大于零小于等于 101 的整数;默认值为 1，即返回第一页数据。当页码超过 101 页时系统就会报错，故请大家在用此接口获取数据时尽可能的细化自己的搜索条件，例如根据修改时间分段获取商品。
page_size	Number	false	40	每页条数。取值范围：大于零的整数;最大值：200；默认值：40。
has_discount	Boolean	false	true	是否参与会员折扣。可选值：true，false。默认不过滤该条件
order_by	String	false	list_time:desc	排序方式。格式为 column:asc/desc ，column 可选值：list_time(上架时间),delist_time(下架时间),num(商品数量)，modified(最近修改时间);默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为 list_time:desc
is_taobao	Boolean	false	true	商品是否在淘宝显示
is_ex	Boolean	false	true	商品是否在外部网店显示
start_modified	Date	false	2000-01-01 00:00:00	商品起始修改时间
end_modified	Date	false	2000-01-01 00:00:00	商品结束修改时间
auction_type	String	false	a	商品类型：a-拍卖，b-一口价
vvtype	int	false		普通版 1，不传默认 1，增强版 2，增强版的需要传参 2，标准版 3,需要标准版的传 3

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	示例值	描述
items	Item []		搜索到底商品列表，具体字段根据设定的 fields 决定，不包括 desc,stuff_status 字段
iid	String	569a64fce2e98bce187bcbbb4a4d262a	商品 id(注意：iid 近期即将废弃，请用 num_iid 参数)
num_iid	Number	1489161932	商品数字 id
title	String	Google test item	商品标题，不能超过 60 字节
nick	String	tbtest561	卖家昵称
type	String	fixed	商品类型(fixed:一口价;auction:拍卖)注：取消团购
cid	Number	132443	商品所属的叶子类目 id
seller_cids	String	2234445,3344466,446434	商品所属的店铺内卖家自定义类目列表
props	String	135255:344454	商品属性格式：pid:vid;pid:vid
pic_url	String	http://img03.taobao.net/bao/uploaded/i3/T1HXdXXgPSt0JxZ2.8_070458.jpg	商品主图片地址
num	Number	8888	商品数量
valid_thru	Number	7	有效期，7 或者 14（默认是 14 天）
list_time	Date	2009-10-22 14:22:06	上架时间（格式：yyyy-MM-dd HH:mm:ss）
delist_time	Date	2000-01-01 00:00:00	下架时间（格式：yyyy-MM-dd HH:mm:ss）
price	Price	5.00	商品价格，格式：5.00；单位：元；精确到：分
has_discount	Boolean	true	支持会员打折，true/false
has_invoice	Boolean	true	是否有发票，true/false
has_warranty	Boolean	true	是否有保修，true/false
has_showcase	Boolean	true	橱窗推荐，true/false
modified	Date	2000-01-01 00:00:00	商品修改时间（格式：yyyy-MM-dd HH:mm:ss）
approve_status	String	onsale	商品上传后的状态。onsale 出售中，instock 库中
postage_id	Number	32	宝贝所属的运费模板 ID，如果没有返回则说明没有使用运费模板
outer_id	String	34143554352	商家外部编码(可与商家外部系统对接)
is_virtual	Boolean	true	虚拟商品的状态字段
is_taobao	Boolean	true	是否在淘宝显示
is_ex	Boolean	true	是否在外部网店显示
total_results	Number	1	搜索到符合条件的结果总数
withholding_money	int	11	该接口扣费金额（点券）

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1460,
    "time": 1617273033,
    "data": {
        "withholding_money": 1,
        
    
        }

}

响应代码

代码	代码描述	解决方案
0	成功
100	请求参数错误	检查您的请求参数是否正确
101	请求超时，请重试	检查您的网络情况或者联系客服解决
200	系统错误，请联系客服	检查您的接口地址填写是否正确，其他问题联系客服解决
202	系统错误，请稍后再试	稍后重试，或者联系对接群
203	暂不支持当前接口
204	请求异常：无该接口权限，请前往官网开通正式接口。	前往官网开通该接口权限
204	请求异常：API 调用次数不足，请前往网站兑换次数。	前往官网充值该接口调用次数
302	未授权店铺	根据返回链接进行扫码授权
401	身份凭证无效	在请求头中添加 access_token
614	系统繁忙，请稍后重试	系统繁忙，请稍后重试
614	系统错误	重试
614	获取仓库中商品列表异常，检查 page_no 是否大于 101 ，大于 101 则报该错误。	细化搜索条件，例如根据修改时间分段获取商品
614	查询的 modified 区间错误	start_modified 必需小于等于 end_modified