Collects one TikTok video directly from the platform and returns its full metadata and engagement counters as of the call. Suited to tracking individual pieces of content rather than whole accounts.
/api/v1/tiktok/realtime/video/detailQuota usage: Each successful request to this endpoint deducts 100 quota units from your plan.
Platform Path Family
/api/v1/{platform}/realtime/video/detailAvailable Platforms
Request Parameters
Required Parameters
| Name | In | Type | Description |
|---|---|---|---|
video_id | query | string | Video ID example: 7447950131443469614 |
region | query | string | country code:US,VN... example: US |
Response Fields
| Name | Type | Description |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.video_id | string | Video ID |
data.description | string | Video description |
data.create_at | string | Publish time |
data.author_uid | string | Author UID |
data.author_unique_id | string | Author unique_id |
data.author_nickname | string | Author nickname |
data.duration | number | Video duration |
data.share_count | integer | Share count |
data.like_count | integer | Like count |
data.comment_count | integer | Comment count |
data.play_count | integer | Play count |
data.collect_count | integer | Save count |
Try It
Query Params
video_id*region*cURL Example
curl -X GET "https://openapi.scdata.cc/api/v1/tiktok/realtime/video/detail?video_id=7447950131443469614®ion=US" \-H "Authorization: YOUR_API_KEY"
Response Example (200 application/json)
{"success": true,"code": 200,"message": "Request successful","data": {"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}}
Use Cases
- Sponsored content reporting — Pull the final numbers of a sponsored video for a campaign wrap-up report.
- Viral content monitoring — Re-check a fast-growing video at intervals to measure how quickly it spreads.