API文档中心

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

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

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

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

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

本接口无需授权。

接口请求地址

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

请求方式:GETPOST

请求参数

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

$api="http://api.veapi.cn/douke/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864";

$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/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864";
        // 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/materials_ProductsDetails?vekey=xxx&product_ids=3590471656293989864"

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

# 获取页面内容
if response.status_code == 200:
	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", "msg": "查询成功!", "data": { "products": [ { "activity_id": 0, "available_coupons": [], "brand": null, "category_id": 9, "category_name": "美妆", "comment_num": 12395, "comment_score": "4.20", "cos_fee": 99, "cos_ratio": 10, "coupon_price": null, "cover": "https://p9-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=AUVtctw", "first_cid": 20085, "has_sxt": true, "imgs": [ "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_0f63b4a3b7a76ca7d6f86aa03365fdf0_sx_441461_www800-800", "https://p6-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://p6-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_f2c42eec64ef7527c5474dc2a47c3cd6_sx_173509_www800-800", "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/nnHBvQXz_m_e4c8ecb8412ad3296e2b8a4b39f3d0b1_sx_260345_www800-800" ], "in_stock": true, "kol_cos_fee": null, "kol_cos_ratio": null, "kol_num": 46373, "logistics_info": "48小时内从广东省发货,包邮", "order_num": 7210962, "presell_type": 2, "price": 990, "product_id": 3592142357828600716, "reason": null, "sales": 13883166, "second_cid": 21328, "sharable": null, "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, "tags": null, "third_cid": 27321, "title": "【粉丝福利】100袋冻干粉免洗睡眠面膜嫩肤补水保湿奶白提亮肤色", "view_num": 891416 } ], "total": 1 }, "request_id": "dff9TM8" }

错误码

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

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部