按 ID 查询单条 Twitch 视频,返回其元数据和当前观看数。
GET
/api/v1/twitch/video/detail额度扣减: 本接口每次成功请求会从套餐额度中扣减 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
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
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"}}
使用场景
- 赞助直播报告 — 为投放报告记录赞助直播的最终观看数。
- 游戏归因 — 查看视频所属的游戏,把主播与该游戏的受众匹配。