按时间顺序分页返回视频的聊天记录,便于把观众反应与直播内容对齐。
GET
/api/v1/twitch/video/messages额度扣减: 本接口每次成功请求会从套餐额度中扣减 1 单位。
请求参数
必填参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
video_id | query | string | Video ID example: 2300924413 |
可选参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
page | query | integer | Page number |
page_size | query | integer | Page size |
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.items | array<object> | Items |
data.total | integer | Total |
data.page | integer | Page |
data.page_size | integer | Page Size |
data.total_pages | integer | Total Pages |
在线调试
https://openapi.scdata.cc/api/v1/twitch/video/messages
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
video_id*pagepage_sizecURL 示例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/twitch/video/messages?video_id=2300924413" \-H "Authorization: YOUR_API_KEY"
响应示例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"message_id": "string","commenter_id": 0,"commenter_name": "string","commenter_display_name": "string","content_offset_seconds": 0,"created_at": "2019-08-24T14:15:22.123Z","message_fragments": "string","message_user_badges": "string","message_user_color": "string"}],"total": 0,"page": 0,"page_size": 0,"total_pages": 0}}
使用场景
- 赞助提及分析 — 衡量赞助环节前后几分钟内聊天的反应。
- 情绪评分 — 把消息输入情绪模型,为每场直播的观众情绪打分。