维易淘客联盟接口开发文档:直播间精选列表

获取淘宝直播联盟的精选直播间列表及直播间商品信息

本接口用于获取淘宝天猫直播间精选列表,及直播间商品列表。


一、直播间精选列表接口:

【使用权限】核心接口会员卡,超级会员卡

【接口用法】

http://api.vephp.com/tbk/livematerial?vekey=xxx&pid=mm_xx&page_num=0

【接口参数】

pid:必选,淘宝联盟推广位,格式:mm_xxx_xxx_xxx

device_type 可选,智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID

device_encrypt 可选,智能匹配-设备号加密类型:MD5,类型为OAID时不传

device_value 可选,智能匹配-设备号加密后的值(MD5加密需32位小写),类型为OAID时传原始OAID值

page_num 可选,默认0,第几页,从0开始

page_size 可选,页大小,默认值20,可选值1-20,最大不超过20

relation_id 可选,渠道关系ID


二、直播间精选列表接口返回值:


total_count  列表中的直播间数量

pv_count  观看数

praise_count  点赞数

location  主播位置

live_url  直播间推广链接

anchor_type  主播身份 daren=达人,shop=商家,目前暂时为空

anchor  主播信息

        user_logo 主播头像

        user_nick  主播昵称:   本参数可以做为接口tbliveinfo的nicknames参数值

item_list 直播间商品列表

        promotion_price 商品价格

        item_name 商品标题

        item_id 商品ID

cover16x9_url 6:9封面链接

cover1x1_url 1:1封面链接

title 直播间标题

live_id 直播间ID

live_room_status 直播间状态 0=预告,1=直播中,2=已结束(回放)


示例:

下例返回值user_nick本参数可以做为接口tbliveinfo的nicknames参数值,比如:

http://api.vephp.com/tbk/tbliveinfo?vekey=xxx&live_query_type=2&nicknames=烈儿宝贝


以下是直播间精选接口的返回值示例:

{

    "error": "0",

    "msg": "获取直播联盟的精选直播间列表成功!",

    "total_count": 195,

    "data": [

        {

            "anchor": {

                "user_logo": "//img.alicdn.com/imgextra/i4/63239528/O1CN01eu6Hwm2KFsL7GDEC1_!!63239528-2-beehive-scenes.png",

                "user_nick": "烈儿宝贝"

            },

            "anchor_type": "daren",

            "cover1x1_url": "https://img.alicdn.com/imgextra/i4/O1CN01nwzKWT21axv7knptE_!!0-tbCommonAudio.jpg",

            "item_list": [],

            "live_id": 306317096761,

            "live_room_status": 1,

            "live_url": "https://huodong.m.taobao.com/act/talent/live.html?id=306317096761&livesource=union_share_union-topapi&bc_fl_src=tunion_live_call&live_ccb=%7B%22outMediaPid%22%3A%22mm_98723245_331450063_96389600002%22%2C%22sourceType%22%3A%221%22%2C%22outSiteCode%22%3A%22isMediaRelay%22%2C%22union_lens%22%3A%22lensId%3AMAPI%401619437104%402104af50_07e1_1790df92ef8_5f97%4001%3BliveId%3A306317096761%3Blivesource%3Aunion_share_union-topapi%22%7D",

            "location": "宁波市",

            "praise_count": 1,

            "pv_count": 931059,

            "title": "了不起的保税仓送锦鲤"

        },

       ...

    ]

}


 

客服