GET
/tiktok/videoGet Video Data
Fetch detailed metadata for a single TikTok video by URL. Returns view count, likes, comments, shares, caption, hashtags, music, and author info.
Quick Start
cURL
curl "https://api.creatorcrawl.com/v1/tiktok/video?url=https://www.tiktok.com/@charlidamelio/video/7345678901234567890" \
-H "x-api-key: YOUR_API_KEY"Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Required | Full TikTok video URL |
Response
JSON Response
{
"id": "7345678901234567890",
"desc": "New dance tutorial #dance #fyp",
"createTime": 1709251200,
"author": {
"uniqueId": "charlidamelio",
"nickname": "Charli D'Amelio",
"verified": true
},
"stats": {
"playCount": 15200000,
"diggCount": 890000,
"commentCount": 12400,
"shareCount": 45000
},
"music": {
"title": "original sound",
"authorName": "Charli D'Amelio"
},
"duration": 32
}Every request costs 1 credit. Response data is live -- never cached.
Use Cases
Video analytics
Pull real-time stats for any TikTok video to track performance over time.
Content curation
Fetch video metadata to power recommendation engines or content feeds.
Viral detection
Monitor videos for engagement spikes to catch trending content early.
Code Examples
Python
import requests
resp = requests.get(
"https://api.creatorcrawl.com/v1/tiktok/video",
params={"url": "https://www.tiktok.com/@charlidamelio/video/7345678901234567890"},
headers={"x-api-key": "YOUR_API_KEY"},
)
video = resp.json()
print(f"{video['stats']['playCount']} views, {video['stats']['diggCount']} likes")JavaScript
const resp = await fetch(
"https://api.creatorcrawl.com/v1/tiktok/video?url=https://www.tiktok.com/@charlidamelio/video/7345678901234567890",
{ headers: { "x-api-key": "YOUR_API_KEY" } }
)
const video = await resp.json()
console.log(`${video.stats.playCount} views, ${video.stats.diggCount} likes`)