接口 2

根据直播间 id 和抖音号获取对应的直播间详细指标，包含互动信息，经营信息。

若传入直播间 id，则会返回对应直播间的详细信息。

若传入抖音号，则获取抖音号作为主播所开播的直播间的详细信息。

接口说明

业务场景：此open_api仅支持查看自挂载，达人挂载直播间的相关数据。

查询限制：暂不开放通用挂载相关数据，原因如下：通用挂载能力下用户的挂载属于自发行为，未经用户授权对经营者开放数据信息涉及数据安全和隐私安全问题，因此暂不对外开放，感谢您的理解。

注意事项：此open_api获取的是离线数据，支持查看近90天所开播的直播间详细数据，当天开播的直播间数据无法在当天查看，请在下一天查看。同时请严格控制该open_api的调用频率**。**

权限要求：服务商代调用场景下，需商家授予数据分析权限集。

错误码

HTTP 状态码	错误码	描述	排查建议
200	11009	参数不合法或缺少参数	校验access_token正确性，校验时间参数正确性，校验hostname正确性
200	-1	系统错误	建议重试，若多次重试失败，可向平台反馈该问题

curl --location --request POST 'https://developer.toutiao.com/api/apps/v1/data_analysis/query_short_live_data_with_id' \ --header 'access-token;' \ --header 'Content-Type: application/json' \ --data-raw '//查询"今天又明天"，"明天何其多"这两个抖音号在 2023年3月20日到 2023年3月21日之间，在抖音端开播的自挂载,达人挂载直播间详细数据 { "start_time": 1679241600, "end_time": 1679328000, "host_name": "douyin", "query_bind_type": 0, "aweme_short_id_list": ["今天又明天","明天何其多"], "query_data_type":5, "page_no":1, "page_size":100 } /**查询"7169582199207939932"，"7169582199207457932"这两个直播间ID中开播时间在 2023年3月20日到 2023年3月21日之间且类型为自挂载的直播间的详细数据**/ { "start_time": 1679241600, "end_time": 1679328000, "query_bind_type": 1, "room_id_list": ["7169582199207939932","7169582199207457932"], "query_data_type":5, "page_no":1, "page_size":100 }'

{ "err_no": 0, "err_msg": "success", "data": { "data_list": [ { "room_id": "7169582199207939932", "app_type": "1128", "room_aweme_shortid": "今天又明天", "room_aweme_type": "1", "room_aweme_nickname": "xxx", "room_aweme_avt": "xxx", "room_duration": "449", "room_create_time": "1679241689", "room_finish_time": "1679241989", "room_highest_online_count": "1", "room_once_watch_duration": "10", "room_comment_count": "1", "room_like_count": "1", "room_share_count": "1", "room_comment_user_count": "1", "room_like_user_count": "1", "room_share_user_count": "1", "mp_show_pv": "2", "mp_click_pv": "2", "mp_drainage_pv": "2", "mp_show_uv": "2", "mp_click_uv": "2", "mp_drainage_uv": "2", "room_show_pv": "3", "room_show_uv": "3", "room_watch_pv": "3", "room_watch_uv": "3", "room_watch_rate": "100%", "room_interactive_rate": "0%", "room_uv_price": "0", "mp_click_rate": "100%", "pay_order_cnt": "1", "pay_customer_cnt": "1", "pay_order_amount": "1", "customer_once_price": "1", "order_once_price": "1", "refund_customer_cnt": "0", "refund_order_cnt": "0", "refund_amount": "0", "bc_relation_bind_type": "0" }, {}, {} ], "sum": 20, "detail_data": {} } }

请求参数

Header 参数

access-token

string

必需

Body 参数application/json

start_time

integer

必需

开始时间，必须是昨天以前的某个时间戳，最好是传入当天的整点时间戳，例如要查询2023年3月20号以来的数据，start_time就传2023-03-20 00:00:00对应的时间戳

end_time

integer

必需

结束时间，必须是昨天以前的某个时间戳，最好是传入当天的整点时间戳，例如要查询截止到2023年3月20号的数据，end_time就传2023-03-20 00:00:00对应的时间戳

host_name

string

可选

宿主APP，douyin-抖音；douyin_lite-抖音lite；toutiao-今日头条；tt_lite-今日头条lite；huoshan-抖音火山版；不传表示查全部端数据

query_bind_type

integer

必需

查询数据的挂载类型，1-自挂载数据，0-自挂载数据+达人挂载数据，目前调用此open_api必须传0或1，传其他值可能产生非预期的结果

aweme_short_id_list

array[string]

必需

没有抖音号列表，需要传递空的字符串数组，如果查询抖音号列表限制长度在200以内，即一次性最多查询 200个抖音号所对应的自挂载,达人挂载视频/自挂载，达人挂载直播间所产生的数据

query_data_type

integer

必需

查询的列表类型，传4表示查询短视频发布数据，传5表示查询直播开播数据

page_no

integer

查询页号，从1开始

必需

page_size

integer

必需

每页的大小（100以内），分页结果按短视频发布时间or直播间开播时间倒序排列

示例

返回响应

🟢200成功

application/json

Body

err_no

integer

必需

err_msg

string

必需

data

object

必需

响应结果（具体结构见下方正常实例）

data_list

array [object {40}]

必需

sum

integer

必需

在查询条件范围内发布视频/直播间的总数

detail_data

object

必需

🟠400请求有误

接口说明#

错误码#

请求参数

返回响应

接口说明

错误码