文档中心 > API类目 > 淘宝客API

taobao.tbk.sc.live.material.get (淘宝客-服务商-直播物料精选)

服务商使用。获取直播联盟的精选直播间列表及推广链接、商品信息等,还可根据用户信息进行智能推荐(智能推荐需先签署协议https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
device_type String 可选 IMEI 智能匹配-设备号类型:IMEI,或者IDFA,或者UTDID(UTDID不支持MD5加密),或者OAID
device_encrypt String 可选 MD5 智能匹配-设备号加密类型:MD5,类型为OAID时不传
device_value String 可选 xxx 智能匹配-设备号加密后的值(MD5加密需32位小写),类型为OAID时传原始OAID值
page_num Number 可选 0
  • 默认值:0
  • 第几页,从0开始
    page_size Number 可选 1
  • 默认值:1
  • 页大小,默认1,最大不超过20
    relation_id Number 可选 72833672 渠道关系ID
    site_id Number 必须 1845950157 mm_xxx_xxx_xxx的第2段数字
    adzone_id Number 必须 13950432 mm_xxx_xxx_xxx的第3段数字

    响应参数

    名称 类型 示例值 描述
    result_list MapData [] [] 直播间列表
    • └ pv_count
    • Number
    • 7289
    • 观看数
    • └ praise_count
    • Number
    • 149
    • 点赞数
    • └ location
    • String
    • 在火星
    • 主播位置
    • └ live_url
    • String
    • //livexxx
    • 直播间推广链接
    • └ anchor_type
    • String
    • daren
    • 主播身份 daren=达人,shop=商家,目前暂时为空
    • anchor
    • Anchor
    • []
    • 主播信息
    • └ user_logo
    • String
    • //gw.alicdn.com/tfs/TB1ny5odf1H3KVjSZFHXXbKppXa-710-388.png
    • 主播头像
    • └ user_nick
    • String
    • 淘客达人
    • 主播昵称
    • item_list
    • ItemMapData []
    • []
    • 直播间商品列表
    • └ pic
    • String
    • //img.alicdn.com/bao/uploaded/i4/2206636496455/O1CN01FouVW31xYRBrF5hRk_!!0-item_pic.jpg
    • 商品图片
    • └ promotion_price
    • String
    • 129.3
    • 商品价格
    • └ item_name
    • String
    • 测试商品
    • 商品标题
    • └ item_id
    • Number
    • 332233223
    • 商品ID
    • └ cover16x9_url
    • String
    • //dkw.16x9.png
    • 16:9封面链接
    • └ cover1x1_url
    • String
    • //dkw.1x1.png
    • 1:1封面链接
    • └ title
    • String
    • 示例直播间
    • 直播间标题
    • └ live_id
    • Number
    • 178229244
    • 直播间ID
    • └ live_room_status
    • Number
    • 1
    • 直播间状态 0=预告,1=直播中,2=已结束(回放)
    total_count Number 12 列表中的直播间数量

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkScLiveMaterialGetRequest req = new TbkScLiveMaterialGetRequest();
    req.setDeviceType("IMEI");
    req.setDeviceEncrypt("MD5");
    req.setDeviceValue("xxx");
    req.setPageNum(0L);
    req.setPageSize(1L);
    req.setRelationId(72833672L);
    req.setSiteId(1845950157L);
    req.setAdzoneId(13950432L);
    TbkScLiveMaterialGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tbk_sc_live_material_get_response>
        <result_list>
            <map_data>
                <pv_count>7289</pv_count>
                <praise_count>149</praise_count>
                <location>在火星</location>
                <live_url>//livexxx</live_url>
                <anchor_type>daren</anchor_type>
                <anchor>
                    <user_logo>//gw.alicdn.com/tfs/TB1ny5odf1H3KVjSZFHXXbKppXa-710-388.png</user_logo>
                    <user_nick>淘客达人</user_nick>
                </anchor>
                <item_list>
                    <item_map_data>
                        <pic>//img.alicdn.com/bao/uploaded/i4/2206636496455/O1CN01FouVW31xYRBrF5hRk_!!0-item_pic.jpg</pic>
                        <promotion_price>129.3</promotion_price>
                        <item_name>测试商品</item_name>
                        <item_id>332233223</item_id>
                    </item_map_data>
                </item_list>
                <cover16x9_url>//dkw.16x9.png</cover16x9_url>
                <cover1x1_url>//dkw.1x1.png</cover1x1_url>
                <title>示例直播间</title>
                <live_id>178229244</live_id>
                <live_room_status>1</live_room_status>
            </map_data>
        </result_list>
        <total_count>12</total_count>
    </tbk_sc_live_material_get_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isp.sys-error 内部服务异常 联系客服
    isp.pid-check-error pid校验出错 检查pid正确性,或联系客服
    isp.adzoneId-not-exist adzoneId不存在 确认adzoneId正确性及是否属于当前用户
    isp.system-result-fail 系统返回异常数据 联系客服
    service-limit 调用频率过高 请降低QPS,稍后重试,或联系客服

    API工具

    如何获得此API

    FAQ

    返回
    顶部