1つの監視IDについて記録された配信を新しい順に返し、各配信の視聴者概要を含みます。
GET
/api/v1/twitch/monitor/live/listクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
monitor_id | query | string | monitor_id example: db78ef84a28644b4983ce6c07b4eeec9 |
任意パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
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/monitor/live/list
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
monitor_id*pagepage_sizecURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/twitch/monitor/live/list?monitor_id=db78ef84a28644b4983ce6c07b4eeec9" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"items": [{"live_id": 0,"user_id": 0,"user_login": "string","user_name": "string","game_id": 0,"game_name": "string","type": "string","title": "string","viewer_count": 0,"started_at": "2019-08-24T14:15:22.123Z","ended_at": "2019-08-24T14:15:22.123Z","language": "string","thumbnail_url": "string","tags": "string","is_mature": 0}],"total": 0,"page": 0,"page_size": 0,"total_pages": 0}}
ユースケース
- 配信ごとの報告 — スポンサー配信者について、セッションごとの視聴者テーブルを作成します。
- スケジュール分析 — 配信者が通常いつ配信を始め、どれくらい続けるかを把握します。