API文档中心

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

达人视角商品详情批量查询-详细版

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

【特别公告】

抖音精选联盟官方平台于3月13日关闭，请参考 https://www.veapi.cn/gonggao/detail_84.html


做为平替，将由穿山甲接口替代，佣金直接在本站会员中心结算。

详情见穿山甲API说明https://www.veapi.cn/apidoc/douyindouke/369



本接口用于查询达人视角下某个/批商品的详情。

本接口需获取 达人授权、抖客授权


和抖客精选联盟的商品详情批量查询（详细版）接口相近，但本接口更适合达人，和详细版接口相对比，本接口多返回

kol_cos_ratio达人佣金比例和kol_cos_fee 达人佣金金额两个字段。

接口请求地址

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

请求方式：GET 或 POST

请求参数

参数名称 参数类型 必填 示例值 描述
vekey String 是 V123M56 公共参数，接口秘钥，请在会员中心获取
product_ids List 是 3534657058714592811, 3534657058714592822 商品ID或URL或商品抖口令，最多20个。注意：如商品推广在抖店后台下架，接口会返回为空。
with_share_status Bool 否 true 是否返回分销状态；true-返回；false-不返回；默认不返回。 根据响应参数sharable字段判断。
with_brand_info Bool 否 false 是否返回品牌信息；true-返回；false-不返回；默认不返回

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
GET/POST  http://api.veapi.cn/douke/kol_MaterialsProductsDetails?vekey=xxx&with_share_status=true&product_ids=3592142357828600716 

【例子】批量查询，商品ID或URL或抖口令商品混合查询
http://api.veapi.cn/douke/kol_MaterialsProductsDetails?vekey=xxx&product_ids=3590471656293989864,3:/%20长按?墆此条消息，达恺ɖȌƱɏɪǸ搜琐，查看商品详情ΦΦv7ettdyQX16B8ÊÊ
使用curl函数，curl不是php原生库，需要安装才能使用

$api="http://api.veapi.cn/douke/kol_MaterialsProductsDetails?vekey=xxx&with_share_status=true&product_ids=3592142357828600716";

$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_MaterialsProductsDetails?vekey=xxx&with_share_status=true&product_ids=3592142357828600716";
        // 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_MaterialsProductsDetails?vekey=xxx&with_share_status=true&product_ids=3592142357828600716"

# 发送请求
response = requests.get(target_url)

# 获取页面内容
if response.status_code == 200:
	print response.text

返回值（JSON）

参数名称 参数类型 示例值 描述
total Int64 10 商品总数
commission_type Int32 1 佣金类型（1-团长普通模式，2-团长竞价模式，3-普通佣金，4-商品定向佣金，5-店铺定向佣金，6-提报活动，7-招募佣金，8-托管团长，9-阶梯佣金）
coupon_price Int64 92 券后价
product_id Int64 3534657058714592866 商品id
title String 测试商品 商品标题
price Int64 100 商品售价（单位为分）
cos_ratio Double 10 普通佣金比例（乘100，例如10%为10）
cos_fee Int64 10 普通佣金金额（单位为分）
first_cid Int64 11 商品一级类目
second_cid Int64 2011 商品二级类目
third_cid Int64 3040 商品三级类目
in_stock Bool true 是否有库存
sales Int64 1000 销量
cover String https://sf1-ttcdn-tos.pstatp.com/img/temai/Fpt8famR3twTGYz09e25nz5PbTRuwww800-800~1125x1125_q50.webp 商品主图
imgs List ["商品轮播图"] 商品轮播图
detail_url String https://haohuo.jinritemai.com/views/product/item2?id=3400312511185213726 商品链接（普通计划链接）
shop_id Int64 1234 店铺ID
shop_name String 测试店铺 店铺名称
status Int32 1 商品活动审核状态
reason String 同意 活动审核原因
kol_cos_ratio Double 10.00 达人佣金比例
kol_cos_fee Int64 100 达人佣金金额（单位为分）
comment_score Double 2 商品评分（5分制，保留一位）
comment_num Int64 2321 商品评价数目
order_num Int64 1232 近30天商品总销量
view_num Int64 5432 近30天商品总浏览量
kol_num Int64 2 近30天推广总达人数
daily_statistics List - 近30天推广达人数、浏览量、和订单量明细
 └─ date String 20210101 日期
 └─ order_num Int64 102 单日商品销量
 └─ view_num Int64 343 单日商品浏览量
 └─ kol_num Int64 1 单日推广达人数
category_name String 玩具乐器 专属团长功能活动对应的限制类目名称
category_id Int64 2 专属团长功能活动对应的限制类目名称id
is_assured Bool true 是否提供安心购服务
logistics_info String 48小时内从浙江省发货 运费3元起 商品物流说明
has_sxt Bool true 是否具有短视频随心推资质
shop_total_score Struct - 商家得分
 └─ shop_score Struct - 商家体验分
    └─ text String 商家体验分 文本
    └─ score String 4.95 得分
    └─ level Int16 1 等级（1:高 2:中 3:低）
 └─ product_score Struct - 商品体验分
 └─ logistics_score Struct - 物流体验分
sharable String true 是否可分销
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": [], "category_id": 9, "category_name": "美妆", "comment_num": 12419, "comment_score": "4.20", "commission_type": 3, "cos_fee": 99, "cos_ratio": 10, "coupon_price": null, "cover": "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_0f63b4a3b7a76ca7d6f86aa03365fdf0_sx_441461_www800-800", "daily_statistics": [ { "date": "20230301", "kol_num": 2754, "order_num": 206118, "view_num": 37534 }, { "date": "20230302", "kol_num": 3480, "order_num": 228393, "view_num": 38276 }, { "date": "20230303", "kol_num": 3317, "order_num": 225819, "view_num": 34114 }, { "date": "20230304", "kol_num": 3090, "order_num": 257103, "view_num": 34925 }, { "date": "20230305", "kol_num": 3650, "order_num": 297792, "view_num": 40744 }, { "date": "20230306", "kol_num": 3207, "order_num": 172458, "view_num": 28140 }, { "date": "20230307", "kol_num": 2510, "order_num": 204534, "view_num": 27598 }, { "date": "20230308", "kol_num": 3136, "order_num": 256311, "view_num": 33447 }, { "date": "20230309", "kol_num": 2963, "order_num": 190476, "view_num": 29835 }, { "date": "20230310", "kol_num": 2313, "order_num": 186219, "view_num": 26928 }, { "date": "20230311", "kol_num": 1851, "order_num": 194634, "view_num": 29432 }, { "date": "20230312", "kol_num": 1971, "order_num": 176418, "view_num": 27401 }, { "date": "20230313", "kol_num": 1999, "order_num": 161667, "view_num": 25432 }, { "date": "20230314", "kol_num": 2328, "order_num": 229086, "view_num": 27689 }, { "date": "20230315", "kol_num": 2188, "order_num": 191070, "view_num": 18971 }, { "date": "20230316", "kol_num": 1321, "order_num": 215226, "view_num": 21644 }, { "date": "20230317", "kol_num": 1775, "order_num": 230967, "view_num": 22274 }, { "date": "20230318", "kol_num": 1904, "order_num": 207405, "view_num": 19908 }, { "date": "20230319", "kol_num": 1671, "order_num": 219681, "view_num": 22469 }, { "date": "20230320", "kol_num": 2514, "order_num": 198000, "view_num": 19243 }, { "date": "20230321", "kol_num": 1776, "order_num": 249678, "view_num": 25452 }, { "date": "20230322", "kol_num": 1744, "order_num": 233640, "view_num": 27580 }, { "date": "20230323", "kol_num": 2037, "order_num": 341253, "view_num": 37829 }, { "date": "20230324", "kol_num": 1253, "order_num": 253143, "view_num": 34253 }, { "date": "20230325", "kol_num": 1864, "order_num": 393723, "view_num": 44578 }, { "date": "20230326", "kol_num": 1763, "order_num": 420750, "view_num": 43853 }, { "date": "20230327", "kol_num": 1750, "order_num": 256311, "view_num": 30789 }, { "date": "20230328", "kol_num": 1607, "order_num": 271557, "view_num": 26892 }, { "date": "20230329", "kol_num": 1646, "order_num": 276606, "view_num": 26516 }, { "date": "20230330", "kol_num": 1536, "order_num": 288684, "view_num": 28098 } ], "detail_url": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3592142357828600716&origin_type=open_platform&pick_source=AUW5SYn", "first_cid": 20085, "has_sxt": true, "imgs": [ "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_0f63b4a3b7a76ca7d6f86aa03365fdf0_sx_441461_www800-800", "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_248d70556c817aa76545d6a7ec32aeef_sx_121687_www800-800", "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_6760c06ffea708f6a4ce36f8b331daed_sx_63685_www790-790", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_f2c42eec64ef7527c5474dc2a47c3cd6_sx_173509_www800-800", "https://p6-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_e4c8ecb8412ad3296e2b8a4b39f3d0b1_sx_260345_www800-800" ], "in_stock": true, "is_assured": false, "kol_cos_fee": 99, "kol_cos_ratio": 10, "kol_num": 46373, "logistics_info": "48小时内从广东省发货，包邮", "order_num": 7210962, "presell_type": 2, "price": 990, "product_id": 3592142357828600716, "reason": null, "sales": 13910292, "second_cid": 21328, "sharable": true, "shop_id": 52225915, "shop_name": "多多美护肤精选个体店", "shop_total_score": { "logistics_score": { "level": 1, "score": "4.76", "text": "物流体验分" }, "product_score": { "level": 1, "score": "4.85", "text": "商品体验分" }, "service_score": { "level": 1, "score": "4.95", "text": "商家服务分" }, "shop_score": { "level": 1, "score": "4.88", "text": "商家体验分" } }, "status": null, "third_cid": 27321, "title": "【粉丝福利】100袋冻干粉免洗睡眠面膜嫩肤补水保湿奶白提亮肤色", "view_num": 891416 } ], "total": 1 }, "request_id": "6iKCKuN" }

错误码

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

在线
客服

点此【QQ在线咨询】QQ号：3252444923

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部