接口使用场景等说明:【注意】本接口将停用,请切换到物料精选接口,参相关通告第6点 https://www.veapi.cn/gonggao/detail_82.html
本文提供淘宝联盟统计的热销产品接口。
产品分类索引:
一级分类(topcate) 二级分类(subcate) 热销 美妆,女装,男装,家居,数码,鞋包,内衣,运动,食品,母婴 优质品 美妆,女装,男装,家居,数码,鞋包,内衣,运动,食品,母婴 母婴 备孕,0至6个月,7至12个月,1至3岁,4至6岁,7至12岁 特价 无二级分类
热销高佣产品库调用示例:
例1:调用热销综合产品(除了vekey,其它参数不需要传)
http://api.veapi.cn/tbk/products?vekey=xxx
例2:调用母婴分类0-6个月
http://api.veapi.cn/tbk/products?vekey=xxx&topcate=母婴&subcate=0至6个月
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/tbk/products | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
topcate | String | 否 | 热销 | 产品一级分类,若不提供本参数,则默认展示“热销”分类下的综合列表。可选值请参考上方概要中的表格 |
subcate | String | 否 | 美妆 | 二级分类,若只有一级分类参数而没有本参数,则表示使用一级分类的综合列表。一级分类(topcate)和二级分类(subcate)参数关系请参考上方概要中的表格。 |
page | Number | 否 | 1 | 页码,默认从1开始 |
pagesize | Number | 否 | 20 | 默认每页返回20笔产品,最大不要超过100 |
ptype | Number | 否 | 产品类别,指定为0表示只要淘宝产品,1表示天猫产品。默认不区分。 | |
onlycoupon | Number | 否 | 默认0 | (可选值1)指定只要带优惠券的产品。 |
sort | Number | 否 | tk_rate_des | 排序参数,默认值 tk_rate_des,产品排序参数有(des表示降序,asc表示升序): (1)按佣金比率 排序:tk_rate_des 默认值,按淘客佣金比率降序, tk_rate_asc 按淘客佣金比率升序, (2)按销量 total_sales_des 按销量降序, total_sales_asc 按销量升序, (3)按优惠券金额排序 coupon_des 按淘客优惠券降序, coupon_asc 按淘客优惠券升序, (4)按产品价格 price_des 按价格降序, price_asc 按价格升序; |
GET/POST http://api.veapi.cn/tbk/products?vekey=xxx&topcate=热销&subcate=男装&page=1&pagesize=20
$api="http://api.veapi.cn/tbk/products?vekey=xxx&topcate=热销&subcate=男装&page=1&pagesize=20"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值
import cn.hutool.http.HttpResponse; import cn.hutool.http.HttpRequest; public class testGetParam { public static void main(String[] args) { // API网址 String url = "http://api.veapi.cn/tbk/products?vekey=xxx&topcate=热销&subcate=男装&page=1&pagesize=20"; // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权 //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", ""); // 发送请求 String result = HttpRequest.get(url) .timeout(10000)//设置超时,毫秒 .execute().body(); System.out.println(result); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/tbk/products?vekey=xxx&topcate=热销&subcate=男装&page=1&pagesize=20" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
item_id | Number | 561417277270 | 产品ID |
title | String | 稻香村特产 | 产品标题 |
pict_url | String | http://....jpg | 主图 |
seller_id | String | 142543794829970 | 卖家ID |
user_type | Number | 1 | 是否为天猫产品,0淘宝,1天猫 |
small_images | String | ..png1|...png2 | 小图组合串,用“|”关联多张图 |
volume | Number | 100 | 商品信息-30天销量(饿了么卡券信息-总销量) |
item_description | String | 夏季凉被 | 商品信息-宝贝描述(推荐理由,不一定有) |
zk_final_price | String | 24.50 | 商品信息-在线售卖价(元)。若属于预售商品,付定金时间内,在线售卖价=预售价 |
commission_rate | String | 6.15 | 佣金比例,百分值 |
coupon_amount | Number | 1.00 | 优惠券面额 |
coupon_start_fee | Number | 6.00 | 优惠券起用条件 |
coupon_total_count | Number | 50000 | 优惠券信息-优惠券总量 |
coupon_remain_count | Number | 50000 | 优惠券信息-优惠券剩余量 |
coupon_start_time | Number | 1668182400 | 优惠券信息-优惠券开始时间 |
coupon_end_time | Number | 1670774399 | 优惠券信息-优惠券结束时间 |
shop_title | String | 润川食品专营店 | 店铺名称 |
item_url | String | https://... | 产品链接 |
{ "error": "0", "msg": "查询成功!", "count": 20, "timer": 1671080210, "data": [ { "item_id": "561417277270", "title": "稻香村特产什锦果脯蜜饯果干小包装桃脯苹果脯杏脯老北京零食小吃", "pict_url": "http://img.alicdn.com/bao/uploaded/i3/870147468/O1CN01MqijfL252OZBjI1ob_!!0-item_pic.jpg", "seller_id": "142543794829970", "user_type": "1", "small_images": "https://img.alicdn.com/i3/870147468/O1CN01bXnIjG252OLJscgnu_!!870147468.jpg|https://img.alicdn.com/i3/870147468/TB2FB6hc22H8KJjy0FcXXaDlFXa_!!870147468.png|https://img.alicdn.com/i3/870147468/O1CN01FCDYjA252OLGyPPaA_!!870147468.jpg|https://img.alicdn.com/i4/870147468/O1CN01252OH3VXruNbBnO_!!870147468.png", "volume": "100", "item_description": "", "zk_final_price": "24.50", "commission_rate": "6.15", "coupon_amount": "1.00", "coupon_start_fee": "5.00", "coupon_total_count": "50000", "coupon_remain_count": "50000", "coupon_start_time": "1668182400", "coupon_end_time": "1670774399", "shop_title": "润川食品专营店", "item_url": "https://detail.tmall.com/item.htm?id=561417277270" } ] }