IDで1本のTwitch動画を検索し、メタデータと現在の視聴数を返します。
GET
/api/v1/twitch/video/detailクォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。
リクエストパラメータ
必須パラメータ
| 名前 | 位置 | 型 | 説明 |
|---|---|---|---|
video_id | query | string | Video ID example: 2300924413 |
レスポンスフィールド
| 名前 | 型 | 説明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.video_id | string | Video ID |
data.stream_id | string | stream_id |
data.user_id | string | user_id |
data.user_login | string | user_login |
data.user_name | string | user_name |
data.title | string | title |
data.description | string | description |
data.created_at | string | created_at |
data.published_at | string | published_at |
data.url | string | url |
data.thumbnail_url | string | thumbnail_url |
data.viewable | string | viewable |
data.view_count | integer | view_count |
data.language | string | language |
data.type | string | type |
data.duration | string | duration |
お試し実行
https://openapi.scdata.cc/api/v1/twitch/video/detail
ダッシュボードのAPIキーを選択
リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く
クエリパラメータ
video_id*cURL の例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/twitch/video/detail?video_id=2300924413" \-H "Authorization: YOUR_API_KEY"
レスポンス例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"video_id": "string","stream_id": "string","user_id": "string","user_login": "string","user_name": "string","title": "string","description": "string","created_at": "2019-08-24T14:15:22.123Z","published_at": "2019-08-24T14:15:22.123Z","url": "string","thumbnail_url": "string","viewable": "string","view_count": 0,"language": "string","type": "string","duration": "string"}}
ユースケース
- スポンサー配信の報告 — キャンペーンレポート用にスポンサー配信の最終視聴数を記録します。
- ゲーム帰属 — 動画がどのゲームで配信されたかを確認し、そのタイトルのオーディエンスに合う配信者を選びます。