API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

抖客搜索接口-检索抖客精选联盟商品(需达人、抖客授权)

调用权限:核心接口会员卡调用
接口使用场景等说明:

【特别公告】

抖音精选联盟官方平台于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(达人佣金金额)两个字段。

调用说明

本接口需要您在会员中心授权(如果多用户可传入sessionkey参数)

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/douke/kol_MaterialsProductsSearch 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
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表示是虚拟产品)

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
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
使用curl函数,curl不是php原生库,需要安装才能使用

$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; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

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);
    }
}
推荐使用 requests,支持访问http,https网页:

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

返回值(JSON)

参数名称 参数类型 示例值 描述
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" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部