全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试
获取当前会话用户出售中的商品列表
接口地址: http://api.vv-tool.com/tool/erps/getonsale
接口介绍: 获取当前用户作为卖家的出售中的商品列表,并能根据传入的搜索条件对出售中的商品列表进行过滤 只能获得商品的部分信息
必须用户授权 : 需要用户的授权,才能拿到被授权的数据
请求方式: POST
返回格式: JSON
接口收费: 联系运营
频率限制: 10 次/秒
请求头参数
参数 | 类型 | 必选 | 值 | 示例 |
---|---|---|---|---|
Authorization | string | 是 | 授权 access_token | Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx |
请求参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
shop_id | String | true | 店铺 ID | |
fields | String | true | num_iid,title,price | 需返回的字段列表。可选值: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,sold_quantity ;字段之间用",”分隔。不支持其他字段,如果需要获取其他字段数据,调用 taobao.item.seller.get 获取。 |
q | String | false | N97 | 搜索字段。搜索商品的 title。 |
cid | Number | false | 1512 | 商品类目 ID。ItemCat 中的 cid 字段。可以通过 taobao.itemcats.get 取到 |
seller_cids | String | false | 11 | 卖家店铺内自定义类目 ID。多个之间用",”分隔。可以根据 taobao.sellercats.list.get 获得。(注:目前最多支持 32 个 ID 号传入) |
page_no | Number | false | 10 | 页码。取值范围:大于零的整数。默认值为 1,即默认返回第一页数据。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过 10 万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品 |
has_discount | Boolean | false | true | 是否参与会员折扣。可选值:true,false。默认不过滤该条件 |
has_showcase | Boolean | false | true | 是否橱窗推荐。 可选值:true,false。默认不过滤该条件 |
order_by | String | false | list_time:desc | 排序方式。格式为 column:asc/desc ,column 可选值:list_time(上架时间),delist_time(下架时间),num(商品数量),modified(最近修改时间),sold_quantity(商品销量),;默认上架时间降序(即最新上架排在前面)。如按照上架时间降序排序方式为 list_time:desc |
is_taobao | Boolean | false | true | 商品是否在淘宝显示 |
is_ex | Boolean | false | true | 商品是否在外部网店显示 |
page_size | Number | false | 100 | 每页条数。取值范围:大于零的整数;最大值:200;默认值:40。用此接口获取数据时,当翻页获取的条数(page_no*page_size)超过 2 万,为了保护后台搜索引擎,接口将报错。所以请大家尽可能的细化自己的搜索条件,例如根据修改时间分段获取商品 |
start_modified | Date | false | 2000-01-01 00:00:00 | 起始的修改时间 |
end_modified | Date | false | 2000-01-01 00:00:00 | 结束的修改时间 |
is_cspu | Boolean | false | true | 是否挂接了达尔文标准产品体系 |
is_combine | Boolean | false | true | 组合商品 |
auction_type | String | false | a | 商品类型:a-拍卖,b-一口价 |
vvtype | int | false | 普通版 1,不传默认 1,增强版 2,增强版的需要传参 2,标准版 3,需要标准版的传 3 |
请求示例
shop_id:123
vvtype:3
fields:num_iid,title,price
请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
响应参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
items | Item [] | 搜索到的商品列表,具体字段根据设定的 fields 决定,不包括 desc 字段 | |
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 | 是否在外部网店显示 |
sold_quantity | Number | 8888 | 商品销量 |
is_cspu | Boolean | true | 是否为达尔文挂接成功了的商品 |
total_results | Number | 150 | 搜索到符合条件的结果总数 |
withholding_money | int | 11 | 该接口扣费金额(点券) |
返回数据
{
"code": 0,
"msg": "操作成功",
"msec": 1306,
"time": 1669968697,
"data": {
"items": {
"item": [
{
"num_iid": 684486601224,
"price": "269.00",
"title": "罗蒙羽绒服男白鸭绒轻薄款男装冬季中年拉链休闲翻领保暖短款外套"
},
{
"num_iid": 684772050065,
"price": "208.00",
"title": "老爷车冬季新款男士羽绒服棉衣加厚保暖中年爸爸领导商务夹克外套"
},
{
"num_iid": 688559373854,
"price": "69.00",
"title": "TUCANO/啄木鳥男士圆领长袖卫衣雪尼尔加绒加厚冬季保暖打底上衣"
},
{
"num_iid": 683445397870,
"price": "258.00",
"title": "旭茂百货秋季男士风衣中长款中年商务过膝外套双排扣休闲大衣上衣"
},
{
"num_iid": 683091660058,
"price": "128.00",
"title": "罗蒙品质男装商务休闲长袖衬衫男秋季新款高弹力免熨烫衬衣职业装"
},
{
"num_iid": 683092600802,
"price": "108.00",
"title": "2071秋季双层棉纱百搭长袖衬衫男士复古休闲青年舒适宽松纯棉衬衣"
},
{
"num_iid": 683094420428,
"price": "256.00",
"title": "罗蒙男装中长款风衣商务百搭春秋西装领中年休闲夹克大码修身外套"
},
{
"num_iid": 681509222305,
"price": "79.00",
"title": "探戈服饰秋季款老虎头潮流图案卫衣男纯棉ins风印花痞帅高街上衣"
},
{
"num_iid": 685082399332,
"price": "258.00",
"title": "罗蒙90白鸭绒冬季男士羽绒服外套2022款青年短款加厚保暖棉服上衣"
},
{
"num_iid": 686486902607,
"price": "138.00",
"title": "TUCANO/啄木鳥秋冬加厚加绒中老年爸爸宽松休闲棉服夹克翻领外套"
},
{
"num_iid": 693091426763,
"price": "59.00",
"title": "松森狼秋冬季男士刺绣加绒polo衫长袖商务休闲宽松翻领上衣打底衫"
},
{
"num_iid": 694489907129,
"price": "78.00",
"title": "TUCANO/啄木鳥冬季加绒卫衣男休闲长袖宽松套头潮流百搭圆领上衣"
},
{
"num_iid": 691062628183,
"price": "69.00",
"title": "勉耕服饰金盾男士加绒加厚圆领雪尼尔衫秋冬季中年保暖卫衣打底衫"
},
{
"num_iid": 688258695217,
"price": "109.00",
"title": "ROMON/罗蒙2022秋冬季男士长袖加绒卫衣中青年圆领男装保暖打底衫"
},
{
"num_iid": 673854454700,
"price": "68.00",
"title": "NYKBOOS时尚男士德绒POLO衫双面绒T恤春季中年休闲百搭男装上衣"
},
{
"num_iid": 673853182245,
"price": "68.00",
"title": "NYKBOOS男士时尚休闲桑蚕丝POLO衫春夏中老年年丝光棉纯色印花长"
},
{
"num_iid": 673850262585,
"price": "168.00",
"title": "香港老爷车专柜男士休闲外套中青年秋季立领百搭夹克上衣帅气茄克"
},
{
"num_iid": 691926691918,
"price": "89.00",
"title": "勉耕服饰金盾冬季加绒加厚足球花纹假俩件针织衫中年男士保暖卫衣"
},
{
"num_iid": 677067442507,
"price": "68.00",
"title": "Mexican/稻草人时尚男士高档华夫格卫衣秋季中青年宽松休闲打底衫"
},
{
"num_iid": 691058364035,
"price": "68.00",
"title": "勉耕服饰金盾男士华夫格加绒加厚圆领卫衣秋冬中年休闲保暖针织衫"
},
{
"num_iid": 674185002452,
"price": "68.00",
"title": "Mexican/稻草人高档时尚男士加绒雪尼尔衫卫衣秋冬保暖毛衣打底衫"
},
{
"num_iid": 683422437582,
"price": "109.00",
"title": "Romon/罗蒙男士秋季时尚立领夹克外套中年休闲宽松商务棒球服茄克"
},
{
"num_iid": 693404497972,
"price": "86.00",
"title": "Romon/罗蒙秋冬款加绒长袖男士卫衣宽松套头中年潮流百搭圆领上衣"
},
{
"num_iid": 691384185223,
"price": "79.00",
"title": "NYKBOOS时尚男士雪尼尔加绒加厚卫衣秋冬季中老年保暖宽松打底衫"
},
{
"num_iid": 673517417953,
"price": "68.00",
"title": "NYKBOOS冬季灯芯绒加绒保暖衬衫长袖修身男士厚条绒休闲保暖衬衣"
},
{
"num_iid": 673857254703,
"price": "118.00",
"title": "香港老爷车男士时尚貂绒衫套头卫衣冬季毛衣中年半高领针织打底衫"
},
{
"num_iid": 673840842482,
"price": "78.00",
"title": "老爷车专柜时尚男士纯棉POLO衫春季假两件卫衣长袖休闲桑蚕丝打底"
},
{
"num_iid": 684194142843,
"price": "158.00",
"title": "抖音快手同款秋季男套装立领卫衣外套时尚百搭刺绣运动休闲两件套"
},
{
"num_iid": 687685917391,
"price": "169.00",
"title": "罗蒙冬季时尚袖章休闲保暖外套男士棉衣中老年父亲装加厚上衣男装"
},
{
"num_iid": 691051124728,
"price": "68.00",
"title": "抖音同款Mexican/稻草人秋冬新款分肩式刺绣加绒华夫格时尚卫衣男"
},
{
"num_iid": 681581260156,
"price": "108.00",
"title": "NYKBOOS初秋时尚男士工装格子纯棉长袖衬衫中青年时尚休闲薄衬衣"
},
{
"num_iid": 692538882205,
"price": "239.00",
"title": "抖音ROMON/罗蒙短款羽绒服男商务休闲白鸭绒时尚冬季保暖男装外套"
},
{
"num_iid": 681927801640,
"price": "98.00",
"title": "罗蒙精品男士休闲长袖冰丝抗皱衬衫秋季商务正装衬衣免烫修身寸衫"
},
{
"num_iid": 681931109225,
"price": "118.00",
"title": "Romon/罗蒙男士加绒长袖衬衫休闲2022秋冬季中年男士商务免烫衬衣"
},
{
"num_iid": 693660246699,
"price": "108.00",
"title": "Romon/罗蒙秋冬新款男士加绒加厚衬衫中青年无痕长袖商务休闲衬衣"
},
{
"num_iid": 683989496104,
"price": "89.00",
"title": "抖音Mexican/稻草人秋季烫钻刺绣假两件卫衣加绒保暖中年男装上衣"
},
{
"num_iid": 676516381923,
"price": "128.00",
"title": "【品牌奥莱】罗蒙秋季时尚立领夹克外套男中青年休闲宽松商务上衣"
},
{
"num_iid": 688249835952,
"price": "59.00",
"title": "TUCANO/啄木鳥华夫格圆领卫衣秋季中年加绒加厚休闲时尚百搭上衣"
},
{
"num_iid": 684005671543,
"price": "169.00",
"title": "Romon/罗蒙秋冬季中年加绒加厚夹克男士中老年商务休闲外套爸爸装"
},
{
"num_iid": 687343404737,
"price": "189.00",
"title": "Romon/罗蒙冬季中老年爸爸装棉服可脱卸毛领翻领加厚保暖休闲棉衣"
}
]
},
"total_results": 302,
"request_id": "15rj4g755w9jj",
"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 |
614 | 获取数据太多,接口报错 | 根据搜索条件缩小获取数据量 |
614 | 用户信息不存在 | 确定用户的正确性 |
614 | 服务不可用 | 重试 |
614 | 数字超过大小范围 | 确定数字格式正确性 |
614 | 翻页获取的条数(page_no*page_size)超过 2 万,为了保护后台搜索引擎,接口报错 | 细化搜索条件,例如根据修改时间分段获取商品 |
614 | 缺少必要的传入参数 | 确定入参的正确性 |
614 | user 不存在 | 传入的 nick 找不到对应的用户记录,尽量通过接口获取 nick 来查询,并且定期更新自己的 nick 数据 |
614 | 接口响应超时 | 重试 |