在请求时直接从 YouTube 平台采集红人资料,而不是读取持久化库。当数据新鲜度比吞吐量更重要时使用;实时调用消耗的配额高于库内读取。
GET
/api/v1/youtube/realtime/user/info额度扣减: 本接口每次成功请求会从套餐额度中扣减 100 单位。
平台路径族
/api/v1/{platform}/realtime/user/info可切换平台
请求参数
必填参数
该接口没有必填参数。
可选参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
channel_id | query | string | channel_id example: UCUFgkRb0ZHc4Rpq15VRCICA |
username | query | string | username example: nike |
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.channel_id | string | Channel ID |
data.username | string | Channel handle |
data.title | string | Channel name |
data.profile_url | string | Channel URL |
data.description | string | Channel description |
data.subscriber_count | integer | Subscriber count |
data.video_count | integer | Video count |
data.country | string | Country |
在线调试
https://openapi.scdata.cc/api/v1/youtube/realtime/user/info
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
channel_idusernamecURL 示例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/youtube/realtime/user/info" \-H "Authorization: YOUR_API_KEY"
响应示例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"channel_id": "string","username": "string","title": "string","profile_url": "string","avatar": "string","description": "string","subscriber_count": 0,"video_count": 0,"country": "string"}}
使用场景
- 投放前刷新 — 在签约前刷新候选红人的最新数据,让合同依据当天的粉丝规模。
- 补齐库内缺口 — 当库内查询没有该红人的记录时,触发实时采集获取资料。