API文档中心

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

抖客精选联盟的商品详情批量查询（详细版）

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

1、本接口用于查询单个或批量推广商品的详情 

2、如商品推广在抖店后台下架，接口会返回为空。

本接口无需授权。

接口请求地址

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

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

  1. $api="http://api.veapi.cn/douke/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864";
  2.  
  3. $ch = curl_init();
  4. curl_setopt($ch, CURLOPT_URL, $api);
  5. //curl_setopt($ch, CURLOPT_POST, true);  //POST方式时启用
  6. //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData );  //POST方式时传参
  7.  
  8. curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);  //如果使用https请启用
  9. curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);  //如果使用https请启用
  10. curl_setopt($ch, CURLOPT_RETURNTRANSFER, true );   //返回数据流，不直接输出
  11. curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快
  12. curl_setopt($ch, CURLOPT_TIMEOUT, 6);  //允许执行的最长秒数。这里设定6S
  13. curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5);
  14.  
  15. $result = curl_exec($ch);
  16. $info = curl_getinfo($ch);
  17. curl_close($ch);
  18.  
  19. echo $result; //返回值
使用okhttp3/httpclient/jsoup/hutool，以hutool为例：

  1. import cn.hutool.http.HttpResponse;
  2. import cn.hutool.http.HttpRequest;
  3.  
  4. public class testGetParam {
  5.  
  6.     public static void main(String[] args) {
  7.         // API网址
  8.         String url = "http://api.veapi.cn/douke/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864";
  9.         // JDK 8u111版本后，若目标页面为HTTPS协议，请启用proxy用户密码鉴权
  10.         //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", "");
  11.  
  12.         // 发送请求
  13.         String result = HttpRequest.get(url)
  14.                 .timeout(10000)//设置超时，毫秒
  15.                 .execute().body();
  16.         System.out.println(result);
  17.     }
  18. }
推荐使用 requests，支持访问http,https网页：

  1. import requests
  2.         
  3. # 要访问的API网页
  4. target_url = "http://api.veapi.cn/douke/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864"
  5.  
  6. # 发送请求
  7. response = requests.get(target_url)
  8.  
  9. # 获取页面内容
  10. if response.status_code == 200:
  11.     print response.text

返回值（JSON）

参数名称 参数类型 示例值 描述
total Int64 10 商品总数
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 同意 活动审核原因
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
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 - 物流体验分
coupon_price Int64 92 券后价
sharable String true 是否可分销
brand Struct - 品牌信息
 └─ brand_id Int64 312131 品牌ID
 └─ brand_name_cn String 测试品牌名 品牌名
 └─ brand_name_en String English brand name 品牌英文名
tags Struct - 标签
 └─ has_shop_brand_tag Bool false 是否有品牌旗舰店标签（[品牌]黑标）
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时，请点此查看错误码表格

在线
客服

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

会员请加QQ群交流：

微信
咨询

加微信咨询
顶部