在线
客服
会员请加QQ群交流：
微信
咨询
加微信咨询
接口使用场景等说明：【特别公告】
抖音精选联盟官方平台于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 | 暂无 |
| 参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|
| 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-不返回；默认不返回 |
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ÊÊ
$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; //返回值
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);
}
}
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
| 参数名称 | 参数类型 | 示例值 | 描述 |
|---|---|---|---|
| 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" }