全部
淘宝
拼多多
抖音
京东
快手
当当
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 接口响应超时 重试