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://hproxy.com/v1/scrape/tiktok/live-status \
  -H "Authorization: Bearer $HPROXY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"thejustalex"}'
POST // 1 call · $0.0030 · <2s
Response200 OK
{
  "platform": "tiktok",
  "scraper": "tiktok-live-status-by-handle",
  "input": {
    "handle": "thejustalex"
  },
  "data": {
    "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
  },
  "records": 1,
  "costUsd": 0.01,
  "requestId": "run_3Qm8x2V7nKp4dWcF",
  "elapsedMs": 1840
}
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

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

$0.0030
per call

TikTok Profile Region

/v1/scrape/tiktok/profile-region

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

$0.0030
per call

TikTok User Audience Demographics

/v1/scrape/tiktok/audience

Audience country breakdown for a public TikTok creator.

$0.0780
per call

TikTok Video

/v1/scrape/tiktok/video

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