動画のチャット記録を時系列でページ単位で返し、配信中の出来事と視聴者の反応を対応付けられます。
GET
/api/v1/twitch/video/messagesクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 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
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
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}}
ユースケース
- スポンサー言及分析 — スポンサー枠の前後数分間のチャットの反応を測定します。
- 感情スコアリング — メッセージを感情分析モデルに入力し、配信ごとの視聴者ムードをスコア化します。