接口使用场景等说明:【特别公告】
抖音精选联盟官方平台于3月13日关闭,请参考 https://www.veapi.cn/gonggao/detail_84.html
做为平替,将由穿山甲接口替代,佣金直接在本站会员中心结算。
详情见穿山甲API说明 https://www.veapi.cn/apidoc/douyindouke/369
本接口用于搜索抖店小店入驻抖客精选联盟的商品。可根据筛选条件过滤出满足条件的商品,也可根据排序条件对检索出来的商品进行排序。接口返回的商品列表会受授权达人推荐策略的影响,同时响应结果增加了达人佣金率和佣金。
本接口需获取达人授权、抖客授权。
和materials_ProductsSearch免授权的搜索接口区别是本接口受达人推荐策略的影响。同时,本接口返回kol_cos_ratio (达人佣金比例)和 kol_cos_fee(达人佣金金额)两个字段。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/douke/kol_MaterialsProductsSearch | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
title | String | 否 | 测试商品名称 | 搜索关键字,支持:商品标题、商品ID、商品链接、商品抖口令,返回标题中包含某个关键词的商品,或指定商品ID的精准产品 |
first_cids | List | 否 | [1,2,3,4]或1,2,3,4 | 筛选商品一级类目 |
second_cids | List | 否 | [22]或22 | 筛选商品二级类目 |
third_cids | List | 否 | [333]或333 | 筛选商品三级类目 |
price_min | Int32 | 否 | 1 | 筛选价格区间-最小值(单位为分) |
price_max | Int32 | 否 | 1000 | 筛选价格区间-最大值(单位为分) |
sell_num_min | Int32 | 否 | 0 | 筛选历史销量区间-最小值 |
sell_num_max | Int32 | 否 | 1000 | 筛选历史销量区间-最大值 |
search_type | Int32 | 否 | 0 | 召回结果排序条件,0默认排序1历史销量排序2价格排序3佣金金额排序4佣金比例排序; |
sort_type | Int32 | 否 | 0 | 排序顺序(0升序1降序),默认0 |
cos_fee_min | Int32 | 否 | 1 | 筛选普通佣金区间-最小值(单位为分) |
cos_fee_max | Int32 | 否 | 50 | 筛选普通佣金区间-最大值(单位为分) |
cos_ratio_min | Int32 | 否 | 1 | 筛选普通佣金率区间-最小值 (乘100,例如1.1%为110) |
cos_ratio_max | Int32 | 否 | 15 | 筛选普通佣金率区间-最大值(乘100,例如1.1%为110) |
page | Int64 | 否 | 1 | 分页(从1开始),默认1 |
page_size | Int64 | 否 | 10 | 每页的数量(小于等于20),默认10 |
share_status | Int32 | 否 | 1 | 获取商品分销状态。1: 仅返回可分销商品;0:返回全量商品 |
activity_id | Int64 | 否 | 1 | 获取活动商品。1: 返回超值购商品;0:返回全量商品 |
virtual | Int32 | 否 | 默认0 | 指定是否过滤或检测虚拟类产品,可选值0、1、2,苹果APP或微信小程序上架时需要用到,可临时开启,参数值:默认0表示不检查虚拟类商品,1表示检测并拒绝虚拟类商品搜索(此时接口error为91),2表示只检测不过滤,这时返回值中增加一个字段is_virtual(值0表示不是虚拟产品,1表示是虚拟产品) |
GET/POST http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xxx&title=面膜【例子】搜索指定ID的产品
http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xx&title=3592142357828600716【例子】搜索指定URL的产品
http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xx&title=https://haohuo.jinritemai.com/views/product/detail?id=3592142357828600716(请urlencode)【例子】搜索口令的产品
http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xx&title=3:/%20长按?墆此条消息,达恺ɖȌƱɏɪǸ搜琐,查看商品详情ΦΦv7ettdyQX16B8ÊÊ(请urlencode)【例子】搜索分类
http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xx&first_cids=20085,20017【例子】过滤虚拟产品
http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xx&title=月卡&virtual=1
$api="http://api.veapi.cn/douke/kol_MaterialsProductsSearch?vekey=xxx&title=面膜"; $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/douke/kol_MaterialsProductsSearch?vekey=xxx&title=面膜"; // 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/douke/kol_MaterialsProductsSearch?vekey=xxx&title=面膜" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
total | Int64 | 1000 | 商品总数 |
commission_type | Int32 | 1 | 佣金类型(1-团长普通模式,2-团长竞价模式,3-普通佣金,4-商品定向佣金,5-店铺定向佣金,6-提报活动,7-招募佣金,8-托管团长,9-阶梯佣金) |
product_id | Int64 | 3400312511185213726 | 商品id |
title | String | 测试商品 | 商品标题 |
price | Int64 | 100 | 商品售价(单位为分) |
cos_ratio | Double | 10 | 普通佣金比例(乘100,例如10%为10) |
cos_fee | Int64 | 1 | 普通佣金金额(单位为分) |
first_cid | Int64 | 1206 | 商品一级类目 |
second_cid | Int64 | 1402 | 商品二级类目 |
third_cid | Int64 | 2634 | 商品三级类目 |
in_stock | Bool | 1 | 是否有库存 |
sales | Int64 | 1234 | 历史总销量 |
cover | String | https://sf1-ttcdn-tos.pstatp.com/img/temai/Fpt8famR3twTGYz09e25nz5PbTRuwww800-800~1125x1125_q50.webp | 商品主图 |
detail_url | String | https://haohuo.jinritemai.com/views/product/item2?id=3400312511185213726 | 商品链接(普通计划链接) |
shop_id | Int64 | 2232 | 店铺ID |
shop_name | String | maggie测试小铺 | 店铺名称 |
coupon_price | Int64 | 92 | 券后价(单位:分) |
sharable | Bool | true | 是否可分销 |
kol_cos_ratio | Double | 10.00 | 达人佣金比例 |
kol_cos_fee | Int64 | 10 | 达人佣金金额(单位为分) |
activity_id | Int64 | 1 | 商品参与活动id。0:未参加活动;1: 超值购 |
presell_type | Int64 | 0 | 预售类型。0:非预售,1;全款预售,2:阶梯库存 |
available_coupons | List | - | 优惠券列表 |
└─ coupon_type | Int32 | 1 | 优惠券类型:1 平台券 2 店铺券 3 主播券 |
└─ type_desc | String | 平台券 | 优惠券类型描述:平台券/主播券/店铺券 |
└─ discount_desc | String | 满20减1 | 优惠券内容描述 |
└─ apply_start_time | String | 2016-01-01 12:00:00 | 优惠券领取开始时间 |
└─ apply_end_time | String | 2016-01-01 13:00:00 | 优惠券领取结束时间 |
└─ validity_type | Int64 | 1 | 优惠券有效期类型:1固定有效期类型,2浮动有效期类型 |
└─ use_start_time | String | 2016-01-01 12:00:00 | 1固定有效期类型,优惠券使用开始时间 |
└─ use_end_time | String | 2016-01-01 13:00:00 | 1固定有效期类型,优惠券使用结束时间 |
└─ valid_period | Int64 | 3600 | 2浮动有效期类型,领取优惠券后有效期,单位s |
{ "error": "0", "msg": "查询成功!", "data": { "products": [ { "activity_id": 0, "available_coupons": [], "commission_type": 3, "cos_fee": 99, "cos_ratio": 10, "coupon_price": null, "cover": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_0f63b4a3b7a76ca7d6f86aa03365fdf0_sx_441461_www800-800", "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3592142357828600716&origin_type=open_platform&pick_source=AUNWHLm", "first_cid": 20085, "in_stock": true, "kol_cos_fee": 99, "kol_cos_ratio": 10, "presell_type": 2, "price": 990, "product_id": 3592142357828600716, "sales": 13842972, "second_cid": 21328, "sharable": true, "shop_id": 52225915, "shop_name": "多多美护肤精选个体店", "third_cid": 27321, "title": "【粉丝福利】100袋冻干粉免洗睡眠面膜嫩肤补水保湿奶白提亮肤色" } ], "total": 1 }, "request_id": "typnuNV" }