Social Media · TikTok Scraper
TikTok Live Status Scraper API
Check whether a TikTok creator is live right now, with viewer count, stream title and playback URLs in each quality. No headless browsers, no captchas, proxies included.
// TikTok · Live Status
curl -H "X-API-Key: hpx_your_key_here" \
"https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=tiktok"
// → { "data": { … }, "records": 1, "costUsd": … }
Facebook
YouTube
Instagram
LinkedIn
Twitter / X
Reddit
Threads
Google
Pinterest
Twitch
Bluesky
Truth Social
Spotify
Snapchat
SoundCloud
Kick
Linktree
Komi
Pillar
Linkbio
Linkme
AmazonFrom Request to Clean JSON
You write one line. We do everything between the request and the data.
You send
One API call
GET the TikTok endpoint with your key. That's all your code does.
We handle
Proxies · captchas · parsing
Residential exit, anti-bot walls, JS rendering and extraction, all server-side, on us.
You get
Clean JSON
A structured object every time. No HTML, no scraping code, no maintenance.
The TikTok Live Status endpoint is one API call: send an account handle with your HProxy key and get back a clean, structured JSON object. Check whether a TikTok creator is live right now, with viewer count, stream title and playback URLs in each quality. HProxy runs the proxies, sessions, anti-bot handling and parsing server-side, so there is no headless browser to babysit and no parser to keep fixing when TikTok changes its markup. You only ever touch the JSON.
What the TikTok Live Status API returns
isLive
Whether the creator is broadcasting right now.
viewerCount
Current concurrent viewers.
title / startedAt
Stream title and when it went live.
playbackUrls
Stream URLs in each available quality.
Example response
{
"isLive": true,
"title": "building the thing, live",
"viewerCount": 4213,
"startedAt": "2026-07-29T17:02:00Z",
"playbackUrls": { "hd": "https://.../hd.m3u8", "sd": "https://.../sd.m3u8" }
}Trimmed for brevity. Every call returns the full object with all fields listed here.
The TikTok live status endpoint
Full TikTok reference →/api/v1/scrape/tiktok/live-statusParameters
handlestringrequiredAccount handle or @username.
trimbooleanoptionalReturn a slimmed-down payload (drops verbose fields).
Example request
curl "https://hproxy.com/api/v1/scrape/tiktok/live-status?handle=tiktok" \
-H "X-API-Key: hpx_your_key_here"POST with a JSON body works too. Failed calls, timeouts and rate-limited calls are never billed.
Scraping TikTok live status in three steps
Create a free account
Sign up and top up any amount. The balance pays for every HProxy product and never expires.
Grab your API key
One key from the dashboard authenticates every scraper, TikTok live status included.
Call the endpoint
Send the target to the TikTok Live Status endpoint and read the JSON. That is the whole integration.
No captchas, ever
Anti-bot walls, JS rendering and rate limits are handled server-side. You call an API, that is the whole job.
Residential-backed
Every request exits through HProxy's own residential network, so it looks like a real user on a real device.
Pay per call
No subscription, no seat licenses. Calls are billed from your balance and the balance never expires.
Fresh on every call
Responses are scraped live at request time, no stale cache dressed up as data.
Failures are free
Automatic retries first; if an extraction still fails, the call is not charged.
Scales with you
From one call to millions: same endpoint, same price curve, volume discounts as you grow.
What people build with it
Notify a community the second a creator goes live.
Track concurrent viewers across a roster of creators.
Trigger automations off live status.
TikTok Live Status pricing
$3.00
per 1,000 calls · 0.3¢ each
Pay per call, no subscription
Failed extractions are not charged
Proxies included in the price