§ TikTok/Live Status
TikTok

TikTok Live Status Scraper API

Real-time live-status detection for any public TikTok creator, with stream playback URLs in multiple qualities.

From $0.0030 per call·Median under 2s·One charge per call
Try it in the dashboardStart free
§ One call

Send a handle.
Get back JSON.

This endpoint takes one input: handle. The response carries the parsed TikTok entity — every public field, in a flat, predictable shape.

Request
cURL
curl https://api.hproxy.com/v1/scrape/tiktok/live/status/by/handle \
  -H "Authorization: Bearer $HPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"thejustalex"}'
POST // 1 call · $0.0030 · <2s
Response200 OK
{
  "liveRoomUserInfo": {
    "user": {
      "userId": "6863550158336541190",
      "uniqueId": "thejustalex",
      "nickname": "Just Alex",
      "avatarLarger": "https://p16-sign-va.tiktokcdn.com/aweme/1080x1080/….jpg",
      "signature": "live every night · 8pm EST · twitch.tv/thejustalex",
      "verified": false,
      "roomId": "7506201943188752150"
    },
    "liveRoom": {
      "status": 2,
      "roomId": "7506201943188752150",
      "title": "RANKED warzone — squads",
      "coverUrl": "https://p16-webcast.tiktokcdn.com/img/cover/….jpg",
      "startTime": 1746014382,
      "liveType": "official_activity",
      "liveTypeAudio": false,
      "liveTypeRecord": false,
      "hashtag": {
        "id": "1652558",
        "title": "gaming"
      }
    },
    "stats": {
      "viewerCount": 1284,
      "totalViewerCount": 8421,
      "likeCount": 49216,
      "diggCount": 49216
    },
    "streamUrl": {
      "rtmpPullUrl": "https://pull-rtmp.tiktokcdn.com/stage/stream-7506201943188752150.flv",
      "flvPullUrl": {
        "SD": "https://pull-flv.tiktokcdn.com/stage/stream-7506201943188752150_sd.flv",
        "HD": "https://pull-flv.tiktokcdn.com/stage/stream-7506201943188752150_hd.flv",
        "ORIGIN": "https://pull-flv.tiktokcdn.com/stage/stream-7506201943188752150.flv"
      },
      "hlsPullUrl": "https://pull-hls.tiktokcdn.com/stage/stream-7506201943188752150.m3u8"
    }
  },
  "isLive": true
}
What comes backparsed fields
TikTok Live Status
tiktok_live_room
userobject
liveRoomobject
statsobject
streamUrlobject
One real call · one structured record
§ What you get

Structured data,
not a scraping project.

Check whether a TikTok user is currently live and fetch their stream details.

Live JSON, returned in seconds
No login flows, no captcha solving
Pay-as-you-go, priced in dollars
Same API key across every scraper
Idempotent retries via X-Request-Id
REST — works from any language
§ Built for

The work that
needs this data.

§ 01

Lead generation

Pull TikTok signals at scale and enrich your CRM with public profile data — clean, structured, ready to import.

§ 02

Market research

Track competitors, audience movements, and trends across TikTok without standing up any scraping infrastructure.

§ 03

AI training data

Feed predictable TikTok JSON straight into your model fine-tuning pipeline. Same schema every call.

§ More TikTok

The rest of the
TikTok hub.

See all 25 endpoints

TikTok Profile

/v1/scrape/tiktok/profile/collect/by/handle

Public TikTok profile metadata, follower counts, and recent video stats.

$0.0030
per call

TikTok Profile Region

/v1/scrape/tiktok/profile/region/by/handle

Detect the country/region a public TikTok profile is registered in.

$0.0030
per call

TikTok User Audience Demographics

/v1/scrape/tiktok/user/audience/demographics

Audience country breakdown for a public TikTok creator.

$0.0780
per call

TikTok Video

/v1/scrape/tiktok/video/collect/by/url

Fetch detailed metadata, play counts and download URLs for a TikTok video.

$0.0330
per call
§ Try it

Two dollars,
first run.

Sign in with Google, drop $2 in the wallet, fire your first Live Status call against tiktok.com. If it doesn’t do what you need, the balance is refundable for 24 hours.

Continue with Google