获取Twitch视频徽标数据

汇总视频期间所有聊天用户的徽标，用于估算受众中订阅者和高投入用户的比例。

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

额度扣减: 本接口每次成功请求会从套餐额度中扣减 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

在线调试

请求地址

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

鉴权

请先从 Dashboard 选择一个 API key

发送请求前请先准备一个 API key。前往 Dashboard

查询参数

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"
          }
        ]
      }
    }
  }
}

使用场景

社区粘性 — 优先选择聊天中订阅者占比高的主播。
受众质量核查 — 以徽标多样性作为观众是真实、活跃社区成员的信号。