返回提交历史
Added
docs/live/live_data.md
+183
-0
XFEstudio/bilibili-API-collect
创建“直播数据”文档
添加“获取直播场次的直播数据”接口 添加“获取直播表现”接口
bdc05a3
代码差异
1 个文件
+183
-0
@@ -0,0 +1,183 @@
1
# 直播数据
2
3
## 获取直播场次的直播数据
4
5
> https://api.live.bilibili.com/xlive/app-blink/v1/live/StopLiveData
6
7
*请求方法: GET*
8
9
认证方式: Cookie (SESSDATA)
10
11
只能获取自己的直播数据。最好在直播结束时立即请求，否则直播时长可能不准确。
12
13
**URL参数：**
14
15
| 参数名 | 类型 | 内容 | 必要性 | 备注 |
16
| ----- | --- | ---- | ----- | --- |
17
| live_key | str | 标记直播场次的key | 必要 | 若不提供将会获得无效数据 |
18
19
**json回复：**
20
21
根对象：
22
23
| 字段 | 类型 | 内容 | 备注 |
24
| --- | --- | --- | --- |
25
| code | num | 返回值 | 0：成功<br />-101：未登录 |
26
| message | str | 提示信息 | 成功时为`"0"` |
27
| ttl | num | `1` | |
28
| data | obj | 信息本体 | |
29
30
`data` 对象：
31
32
| 字段 | 类型 | 内容 | 备注 |
33
| --- | --- | --- | --- |
34
| LiveTime | num | 该直播场次的直播时长 | 单位:秒，直播结束后还会增长 |
35
| AddFans | num | 该直播场次的新增粉丝 | |
36
| HamsterRmb | num | 该直播场次的收益 | |
37
| NewFansClub | num | 该直播场次新获得粉丝勋章数量 | |
38
| DanmuNum | num | 该直播场次的弹幕条数 | |
39
| MaxOnline | num | 该直播场次的最大在线? | [需要验证] |
40
| WatchedCount | num | 该直播场次的看过人数 | |
41
42
**示例：**
43
44
获取自己的直播数据
45
46
```shell
47
curl 'https://api.live.bilibili.com/xlive/app-blink/v1/live/StopLiveData?live_key=634808443264569139' \
48
-b 'SESSDATA=xxx'
49
```
50
51
<details>
52
<summary>查看响应示例：</summary>
53
54
```json
55
{
56
"code": 0,
57
"message": "0",
58
"ttl": 1,
59
"data": {
60
"LiveTime": 77603,
61
"AddFans": 0,
62
"HamsterRmb": 0,
63
"NewFansClub": 0,
64
"DanmuNum": 3,
65
"MaxOnline": 13,
66
"WatchedCount": 2
67
}
68
}
69
```
70
71
</details>
72
73
## 获取直播表现
74
75
> https://api.live.bilibili.com/xlive/app-blink/v1/date/Overview
76
77
*请求方法: GET*
78
79
认证方式: Cookie (SESSDATA)
80
81
**json回复：**
82
83
根对象：
84
85
| 字段 | 类型 | 内容 | 备注 |
86
| --- | --- | --- | --- |
87
| code | num | 返回值 | 0：成功<br />-101：未登录 |
88
| message | str | 提示信息 | 成功时为`"0"` |
89
| ttl | num | `1` | |
90
| data | obj | 信息本体 | |
91
92
`data` 对象：
93
94
| 字段 | 类型 | 内容 | 备注 |
95
| --- | --- | --- | --- |
96
| graph | arr | 图表数据 | 在界面显示为雷达图 |
97
| propose | null | (?) | |
98
99
`data.graph` 数组：
100
101
| 索引 | 类型 | 内容 | 备注 |
102
| --- | --- | --- | --- |
103
| 0 | obj | 数据类别 | |
104
| … | obj | 数据类别 | |
105
106
`data.graph` 数组中对象：
107
108
| 字段 | 类型 | 内容 | 备注 |
109
| --- | --- | --- | --- |
110
| name | str | 显示的名称 | |
111
| index | str | 类别标识 | |
112
| me | num | 自己在这个类别的数值 | |
113
| max | num | 这个类别最外侧那条线的数值 | |
114
| aver | num | 同水平主播在这个类别的数值 | |
115
116
**示例：**
117
118
获取自己的直播表现
119
120
```shell
121
curl 'https://api.live.bilibili.com/xlive/app-blink/v1/date/Overview' \
122
-b 'SESSDATA=xxx'
123
```
124
125
<details>
126
<summary>查看响应示例：</summary>
127
128
```json
129
{
130
"code": 0,
131
"message": "0",
132
"ttl": 1,
133
"data": {
134
"graph": [
135
{
136
"name": "收益",
137
"index": "income",
138
"me": 0,
139
"max": 9.27,
140
"aver": 8.04
141
},
142
{
143
"name": "累计观看",
144
"index": "watchedCount",
145
"me": 5.13,
146
"max": 7.01,
147
"aver": 6.17
148
},
149
{
150
"name": "新增粉丝",
151
"index": "fans",
152
"me": 0,
153
"max": 2.58,
154
"aver": 0
155
},
156
{
157
"name": "用户平均观看时长",
158
"index": "watchTime",
159
"me": 9.31,
160
"max": 11.82,
161
"aver": 10.88
162
},
163
{
164
"name": "开播时长",
165
"index": "broadcast",
166
"me": 17.57,
167
"max": 17.42,
168
"aver": 16.6
169
},
170
{
171
"name": "弹幕数量",
172
"index": "barrage",
173
"me": 7.37,
174
"max": 8.02,
175
"aver": 6.91
176
}
177
],
178
"propose": null
179
}
180
}
181
```
182
183
</details>