全部
淘宝
拼多多
抖音
京东
快手
当当
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 | 未授权店铺 | 根据返回链接进行扫码授权 |