GET
/tiktok/user/liveGet Live Data
Check if a TikTok user is currently live streaming and get live stream data including viewer count and stream title.
Quick Start
cURL
curl "https://api.creatorcrawl.com/v1/tiktok/user/live?handle=charlidamelio" \
-H "x-api-key: YOUR_API_KEY"Parameters
| Name | Type | Required | Description |
|---|---|---|---|
handle | string | Required | TikTok handle without @ |
Response
JSON Response
{
"isLive": true,
"title": "Q&A with fans!",
"viewerCount": 45000,
"startTime": 1709251200
}Every request costs 1 credit. Response data is live -- never cached.
Use Cases
Live monitoring
Track when creators go live to capture real-time engagement data.
Alert systems
Build notifications when tracked creators start live streams.
Live analytics
Monitor viewer counts and stream durations for live content performance.
Code Examples
Python
import requests
resp = requests.get(
"https://api.creatorcrawl.com/v1/tiktok/user/live",
params={"handle": "charlidamelio"},
headers={"x-api-key": "YOUR_API_KEY"},
)
data = resp.json()
if data["isLive"]:
print(f"LIVE: {data['title']} ({data['viewerCount']} viewers)")JavaScript
const resp = await fetch(
"https://api.creatorcrawl.com/v1/tiktok/user/live?handle=charlidamelio",
{ headers: { "x-api-key": "YOUR_API_KEY" } }
)
const data = await resp.json()
if (data.isLive) console.log(`LIVE: ${data.title} (${data.viewerCount} viewers)`)