全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获取产品列表


接口地址: http://api.vv-tool.com/tool/erps/getproducts


接口介绍: 根据淘宝会员帐号搜索所有产品信息,推荐使用 taobao.products.search
注意:支持分页,每页最多返回 100 条,默认值为 40,页码从 1 开始,默认为第一页点击查看详情


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口 点击查看详情

请求参数

参数 类型 必选 描述
shop_id String 用户昵称
fields String[] 需返回的字段列表。可选值:Product 数据结构中的所有字段;多个字段之间用","分隔
nick String 用户昵称
page_no Number 页码。传入值为 1 代表第一页,传入值为 2 代表第二页,依此类推。默认返回的数据是从第一页开始。
page_size Number 每页条数。每页返回最多返回 100 条,默认值为 40
vvtype Number 2 高级版(必须填 2,不填默认是 2)

请求示例

shop_id:123
fields:products

请求代码示例

cURL请求代码示例

PHP请求代码示例


JAVA请求代码示例


响应参数

名称 类型 示例值 描述
products Product [] 返回具体信息为入参 fields 请求的字段信息
--name String 惠普笔记本 产品名称
--binds String pid:vid;pid:vid 产品的非关键属性列表。格式:pid:vid;pid:vid.
--sale_props String pid:vid;pid:vid 产品的销售属性列表。格式:pid:vid;pid:vid
--price Price 200.07 产品的市场价。单位为元。精确到 2 位小数;如:200.07
--desc String 这是一款产品 产品的描述。最大 25000 个字节
--pic_url String http://host/image_path 产品的主图片地址。(绝对地址,格式:http://host/image_path)
--modified Date 2000-01-01 00:00:00 修改时间。格式:yyyy-mm-dd hh:mm:ss
--product_prop_imgs ProductPropImg[] 产品的属性图片。比如说黄色对应的产品图片,绿色对应的产品图片。fields 中设置为 product_prop_imgs.id、 product_prop_imgs.props、product_prop_imgs.url、product_prop_imgs.position 等形式就会返回相应的字段
----id Number 674443 产品属性图片 ID
----product_id Number 96899 图片所属产品的 ID
----props String 颜色:红色表示为 1627207:28326 属性串(pid:vid),目前只有颜色属性。如:颜色:红色表示为 1627207:28326
----url String http://host/image_path 图片地址。(绝对地址,格式:http://host/image_path)
----position Number 2355 图片序号。产品里的图片展示顺序,数据越小越靠前。要求是正整数。
----created Date 2000-01-01 00:00:00 添加时间。格式:yyyy-mm-dd hh:mm:ss
----modified Date 2000-01-01 00:00:00 修改时间。格式:yyyy-mm-dd hh:mm:ss
----status Number 1 当前状态(0 商家确认 1 屏蔽 3 小二确认 2 未确认 -1 删除)
----product_id Number 3433222 产品 ID
----outer_id String 123456 外部产品 ID
----created Date 2000-01-01 00:00:00 创建时间。格式:yyyy-mm-dd hh:mm:ss
----tsc String hkjki 淘宝标准产品编码
----cid Number 50012286 商品类目 ID.必须是叶子类目 ID
----cat_name String 日用品 商品类目名称
----props String pid:vid;pid:vid 产品的关键属性列表。格式:pid:vid;pid:vid
----props_str String 品牌:诺基亚;型号:N73 产品的关键属性字符串列表。比如:品牌:诺基亚;型号:N73(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#")
----binds_str String 品牌:诺基亚;型号:N73 产品的非关键属性字符串列表。格式同 props_str(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#")
----sale_props_str String 品牌:诺基亚;型号:N73 产品的销售属性字符串列表。格式同 props_str(注:属性名称中的冒号":"被转换为:"#cln#"; 分号";"被转换为:"#scln#")
----product_imgs ProductImg[] 产品的子图片。目前最多支持 4 张。fields 中设置为 product_imgs.id、product_imgs.url、product_imgs.position 等形式就会返回相应的字段
------id Number 9684 产品图片 ID
------product_id Number 96899 图片所属产品的 ID
------url String http://host/image_path 图片地址。(绝对地址,格式:http://host/image_path)
------position Number 2355 图片序号。产品里的图片展示顺序,数据越小越靠前。要求是正整数。
------created Date 2000-01-01 00:00:00 添加时间。格式:yyyy-mm-dd hh:mm:ss
------modified Date 2000-01-01 00:00:00 修改时间。格式:yyyy-mm-dd hh:mm:ss
withholding_money INT 1 该接口扣费金额(点券)

返回数据

{"code": 0, "msg": "操作成功", "msec": 1469, "time": 1617270403, "data": {"products_get_response": {"products": {"product": [{"name": "惠普笔记本", "binds": "pid:vid;pid:vid", "sale_props": "pid:vid;pid:vid", "price": "200.07", "desc": "这是一款产品", "pic_url": "http://host/image_path", "modified": "2000-01-01 00:00:00", "product_prop_imgs": {"product_prop_img": [{}]}, "status": 1, "product_id": 3433222, "outer_id": "123456", "created": "2000-01-01 00:00:00", "tsc": "hkjki", "cid": 50012286, "cat_name": "日用品", "props": "pid:vid;pid:vid", "props_str": "品牌:诺基亚;型号:N73", "binds_str": "品牌:诺基亚;型号:N73", "sale_props_str": "品牌:诺基亚;型号:N73", "product_imgs": {"product_img": [{}]}}]}}}}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权