文档中心 > API类目 > 淘宝直播API

taobao.live.batchlives.get (批量按照直播间ID查询直播元数据)

批量按照直播间ID查询直播元数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
live_ids String [] 可选 1,2,3
  • 最大列表长度:30
  • 直播间ID
    source String 可选 top
  • 默认值:top
  • 来源自定义
    type String [] 可选 1,2,5
  • 最大列表长度:20
  • 类型 1直播元数据 2主播数据 5在线

    响应参数

    名称 类型 示例值 描述
    result Result 接口返回model
    • └ error_code
    • String
    • "isv.invalid-parameter"
    • 错误码
    • └ info
    • String
    • 成功
    • 描述
    • live_list
    • LiveVideoDo []
    • 134523^4351232
    • model
    • └ account_id
    • Number
    • 111
    • 主播ID
    • └ appointment_time
    • Number
    • 112222
    • 预约时间
    • └ approval
    • Number
    • 1
    • 审核状态
    • └ biz_code
    • String
    • TAOBAO
    • 业务域
    • └ cover_img
    • String
    • http://XX
    • 1比1封面
    • └ cover_img169
    • String
    • http://XX
    • 16:9封面
    • └ cover_img916
    • String
    • http://XX
    • 6:19封面
    • └ desc_info
    • String
    • 直播
    • 直播间描述
    • └ end_time
    • Number
    • 1222
    • 结束时间 毫秒
    • └ expired
    • Boolean
    • true
    • 过期
    • └ favor_img
    • String
    • http://XX
    • 点赞图片
    • └ gmt_create_time
    • Number
    • 1
    • 创建
    • └ gmt_modify_time
    • Number
    • 2
    • 修改时间
    • └ id
    • String
    • 1
    • 主键ID
    • └ join_count
    • Number
    • 333
    • 参与人数
    • └ land_scape
    • Boolean
    • false
    • true是横屏
    • └ live_channel_id
    • Number
    • 4
    • 频道ID
    • └ live_column_id
    • Number
    • 5
    • 栏目ID
    • └ live_id
    • Number
    • 1
    • 直播间ID
    • └ live_url
    • String
    • http://XX
    • 播放地址
    • └ live_url_hls
    • String
    • http://XX
    • hls地址
    • live_url_list
    • LiveUrlDo []
    • 地址列表
    • └ code_level
    • Number
    • 1
    • 清晰度
    • └ definition
    • String
    • ld
    • 定义
    • └ flv_url
    • String
    • http://XX
    • flv
    • └ h265_url
    • String
    • http://XX
    • 265播放地址
    • └ hls_url
    • String
    • http://XX
    • hls
    • └ name
    • String
    • 高清
    • 名称
    • └ location
    • String
    • 火星
    • 地址
    • └ native_feed_detail_url
    • String
    • 跳转
    • 跳转
    • └ praise_count
    • Number
    • 点赞数
    • 点赞数
    • └ replay_url
    • String
    • http://XX
    • 回放地址
    • └ room_status
    • Number
    • 1
    • 直播状态 1直播 0预告 2 回放
    • simple_broad_caster
    • SimpleBroadCaster
    • 主播信息
    • └ account_id
    • Number
    • 11
    • 主播ID
    • └ account_name
    • String
    • 薇娅
    • 主播名称
    • └ fans_num
    • Number
    • 233
    • 粉丝数
    • └ head_img
    • String
    • http://XX
    • 头像
    • └ tb_nick
    • String
    • 薇娅
    • 淘宝nick
    • └ level
    • Number
    • 0
    • 主播等级
    • └ start_time
    • Number
    • 3333
    • 开始时间
    • └ status
    • Number
    • 100
    • 删除状态 100正常 -1 删除
    • └ stream_status
    • Number
    • 1
    • 流状态 1 有推流 0没有推流
    • └ tidbits_url
    • String
    • http://XX
    • 花絮
    • └ title
    • String
    • 直播
    • 主标题
    • └ topic
    • String
    • tttt
    • 流名称
    • └ total_view_count
    • Number
    • 1111
    • 总观看
    • └ user_nick
    • String
    • 333
    • nick
    • └ view_count
    • Number
    • 1111
    • PV数 前台显示这个 观看次数
    • └ room_type
    • Number
    • 房间类型
    • └ address_detail
    • String
    • 门店地址描述
    • └ longitude
    • String
    • 经度
    • └ latitude
    • String
    • 纬度
    • └ country_code
    • String
    • 国家编码,高德
    • └ district_code
    • String
    • 区域编码,高德
    • └ province_code
    • String
    • 省份编码,高德
    • └ city_code
    • String
    • 城市编码,高德
    • └ new_room_type
    • String
    • 新直播类型
    • └ show_lbs
    • Boolean
    • false
    • 是否在lbs 展示
    • result_code
    • ResultCode
    • 错误码
    • └ error_code
    • Number
    • 22
    • 错误
    • └ info
    • String
    • 22
    • 提示
    • └ success
    • Boolean
    • false
    • 是否成功
    • └ total_count
    • Number
    • 120
    • 总条数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    LiveBatchlivesGetRequest req = new LiveBatchlivesGetRequest();
    req.setLiveIds("1,2,3");
    req.setSource("top");
    req.setType("1,2,5");
    LiveBatchlivesGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <live_batchlives_get_response>
        <result>
            <error_code>&quot;isv.invalid-parameter&quot;</error_code>
            <info>成功</info>
            <live_list>
                <live_video_do>
                    <account_id>111</account_id>
                    <appointment_time>112222</appointment_time>
                    <approval>1</approval>
                    <biz_code>TAOBAO</biz_code>
                    <cover_img>http://XX</cover_img>
                    <cover_img169>http://XX</cover_img169>
                    <cover_img916>http://XX</cover_img916>
                    <desc_info>直播</desc_info>
                    <end_time>1222</end_time>
                    <expired>true</expired>
                    <favor_img>http://XX</favor_img>
                    <gmt_create_time>1</gmt_create_time>
                    <gmt_modify_time>2</gmt_modify_time>
                    <id>1</id>
                    <join_count>333</join_count>
                    <land_scape>false</land_scape>
                    <live_channel_id>4</live_channel_id>
                    <live_column_id>5</live_column_id>
                    <live_id>1</live_id>
                    <live_url>http://XX</live_url>
                    <live_url_hls>http://XX</live_url_hls>
                    <live_url_list>
                        <live_url_do>
                            <code_level>1</code_level>
                            <definition>ld</definition>
                            <flv_url>http://XX</flv_url>
                            <h265_url>http://XX</h265_url>
                            <hls_url>http://XX</hls_url>
                            <name>高清</name>
                        </live_url_do>
                    </live_url_list>
                    <location>火星</location>
                    <native_feed_detail_url>跳转</native_feed_detail_url>
                    <praise_count>点赞数</praise_count>
                    <replay_url>http://XX</replay_url>
                    <room_status>1</room_status>
                    <simple_broad_caster>
                        <account_id>11</account_id>
                        <account_name>薇娅</account_name>
                        <fans_num>233</fans_num>
                        <head_img>http://XX</head_img>
                        <tb_nick>薇娅</tb_nick>
                        <level>0</level>
                    </simple_broad_caster>
                    <start_time>3333</start_time>
                    <status>100</status>
                    <stream_status>1</stream_status>
                    <tidbits_url>http://XX</tidbits_url>
                    <title>直播</title>
                    <topic>tttt</topic>
                    <total_view_count>1111</total_view_count>
                    <user_nick>333</user_nick>
                    <view_count>1111</view_count>
                    <room_type></room_type>
                    <address_detail></address_detail>
                    <longitude></longitude>
                    <latitude></latitude>
                    <country_code></country_code>
                    <district_code></district_code>
                    <province_code></province_code>
                    <city_code></city_code>
                    <new_room_type></new_room_type>
                    <show_lbs>false</show_lbs>
                </live_video_do>
            </live_list>
            <result_code>
                <error_code>22</error_code>
                <info>22</info>
            </result_code>
            <success>false</success>
            <total_count>120</total_count>
        </result>
    </live_batchlives_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部