Twitch動画のバッジデータを取得

動画中にチャットした全ユーザーのバッジを集計し、購読者や熱心なファンの割合を推定する指標を提供します。

GET/api/v1/twitch/video/badges/data

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 1 単位消費されます。

リクエストパラメータ

必須パラメータ

名前	位置	型	説明
`video_id`	query	string	Video ID example: 2300924413

レスポンスフィールド

名前	型	説明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	object	-
`data.badges`	array<object>	Badges
`data.video`	object	Video

お試し実行

リクエストURL

https://openapi.scdata.cc/api/v1/twitch/video/badges/data

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

クエリパラメータ

video_id*

cURL の例

bash

curl -X GET "https://openapi.scdata.cc/api/v1/twitch/video/badges/data?video_id=2300924413" \
  -H "Authorization: YOUR_API_KEY"

レスポンス例 (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": {
    "badges": [
      {
        "id": "string",
        "set_id": "string",
        "version": "string",
        "title": "string",
        "image1x": "string",
        "image2x": "string",
        "image4x": "string",
        "click_action": "string",
        "click_url": "string"
      }
    ],
    "video": {
      "id": "string",
      "broadcast_type": "string",
      "length_seconds": 0,
      "owner": {
        "id": "string",
        "login": "string",
        "broadcast_badges": [
          {
            "id": "string",
            "set_id": "string",
            "version": "string",
            "title": "string",
            "image1x": "string",
            "image2x": "string",
            "image4x": "string",
            "click_action": "string",
            "click_url": "string"
          }
        ]
      }
    }
  }
}

ユースケース

コミュニティの強さ — チャットに購読者の割合が高い配信者を優先します。
オーディエンス品質確認 — バッジの多様性を、視聴者が本物で積極的なコミュニティメンバーである指標として使います。