淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
淘宝联盟API
京东联盟API
拼多多API
开放平台API
美团联盟
电影票/肯德基
考拉海购
优惠加油
文娱直充
饿了么
滴滴
喵有券联盟
点击获取APKEY

正常 获取直播预告及商品信息列表 接口在线测试

抖客获取直播预告及直播预告商品信息列表

接口地址: http://api.web.ecapi.cn/douyin/instituteLivePreviewList
接口实例: http://api.web.ecapi.cn/douyin/instituteLivePreviewList?apkey=登录会员中心查看&dou_key=xxxx&buyin_id=6945289506111766791
注意事项:如调用接口时数据返回异常,则需对接口中的【中文】及含有【空格】的数据进行Urlencode编码,然后再试。
请求方式:GET
会员范围: 付费会员 (新用户注册立刻送7天V1付费会员【注:赠送会员可使用全部接口,但调用频率与免费会员一致,免费会员调用频率可参考会员等级说明】)
必看注意:为保障接口安全及使用效率,调用本站接口前需先 添加IP白名单 (IP地址测试),若IP不固定且无服务器,可通过“优惠推荐”中的链接购买阿里云服务器来调用接口。禁止以插件(包括但不仅限于浏览器插件及手机插件)形式使用接口,禁止将接口重新打包销售或转卖,一经发现,将做帐号封禁处理。
优惠推荐:高性能云服务器2折起,普惠上云,仅需234元/年 ->>立即抢购<<-

使用说明

暂无说明

请求参数

参数 类型 请求参数参考值 是否必须 说明
apkey String xxxxxxx 用户中心 - 系统设置 - 平台设置 中查看APKEY密钥 (点我获取)*必要
dou_key String xxxx 抖音授权账号调用key,在喵有券会员中心-抖音授权列表页获取
buyin_id String 6945289506111766791 要查询的达人的百应ID
need_product_info Bool false 是否需要预告对应的商品信息。需要商品信息会增加接口耗时,默认false
page Number 1 页码,从1开始
page_size Number 20 每页直播预告数量,最大100

返回参数

返回参数 类型 参数说明 扩展说明
data Json 返回数据
 ├ total Number 总数
 ├ previews Json 直播预告及商品信息列表
 ├  ├ preview_id Number 预告ID
 ├  ├ booking_num Number 预约预告人数
 ├  ├ start_time Number 直播开始时间
 ├  ├ product_count Number 商品数量
 ├  ├ products Json 商品详情列表
 ├  ├  ├ list_num Number 商品在列表序号
 ├  ├  ├ product_id Number 商品ID
 ├  ├  ├ title String 商品名称
 ├  ├  ├ price Number 商品售价(原价,单位为分)
 ├  ├  ├ first_cid Number 商品一级类目
 ├  ├  ├ first_cname String 一级类目名称
 ├  ├  ├ second_cid Number 商品二级类目
 ├  ├  ├ second_cname String 二级类目名称
 ├  ├  ├ third_cid Number 商品三级类目
 ├  ├  ├ third_cname String 三级类目名称
 ├  ├  ├ category_id Number 行业类目
 ├  ├  ├ ads_promotion_ratio Json 渠道推广费率
 ├  ├  ├  ├ share_ratio Number 新客推广费率,返回结果X10000,如10%返回1000
 ├  ├  ├  ├ old_fans_ratio Number 老客推广费率,返回结果X10000,如10%返回1000
 ├  ├  ├ cover String 商品主图
 ├  ├  ├ preview_price Number 商品预告开播价,单位分
 ├  ├  ├ product_desc String 商品卖点

Json返回示例

{

    "code": 200,

    "data": {

        "previews": [],

        "total": 0

    },

    "msg": "success"

}


code/http_status说明

code/http_status 说明
200 数据获取成功
-1 数据获取失败
401 IP没有添加白名单
429 访问次数超限
403 关键参数丢失
405 请求方式不对