在请求时直接从 TikTok 抓取红人最新发布的视频。适用于几小时内发布的内容或库内数据已过时的情况;实时采集消耗的配额高于库内读取。
GET
/api/v1/tiktok/realtime/user/videos额度扣减: 本接口每次成功请求会从套餐额度中扣减 100 单位。
平台路径族
/api/v1/{platform}/realtime/user/videos可切换平台
请求参数
必填参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
uid | query | string | uid or sec_uid example: 208464585232822272 |
可选参数
| 名称 | 位置 | 类型 | 说明 |
|---|---|---|---|
region | query | string | country code:US,VN... example: US |
offset | query | string | offset |
响应字段
| 名称 | 类型 | 说明 |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.more | boolean | Has more |
data.offset | string | offset |
data.videos | array<object> | videos |
在线调试
https://openapi.scdata.cc/api/v1/tiktok/realtime/user/videos
请先从 Dashboard 选择一个 API key
发送请求前请先准备一个 API key。前往 Dashboard
查询参数
uid*regionoffsetcURL 示例
bash
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/realtime/user/videos?uid=208464585232822272" \-H "Authorization: YOUR_API_KEY"
响应示例 (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"more": true,"offset": "string","videos": [{"video_id": "string","description": "string","create_at": "2019-08-24T14:15:22.123Z","author_uid": "string","author_unique_id": "string","author_nickname": "string","duration": 0,"video_url": "string","cover_url": "string","share_count": 0,"like_count": 0,"comment_count": 0,"play_count": 0,"collect_count": 0}]}}
使用场景
- 投放交付核对 — 确认赞助内容已发布,并记录发布后最初几小时的互动数据。
- 热点追踪 — 轮询一批红人的最新视频,尽早捕捉正在兴起的话题。