100 free credits. No credit card required.Start building
Logo
Start for free
TikTok logo
100 free credits. No credit card required

TikTok User Live API

Scrape TikTok User Live data with one API call. Returns the current live-stream state for a TikTok user: `is_live`, and when the account is or has recently been live, the room (title, cover, start time, viewer stats). An account that exists but has never streamed returns `is_live: false` with an empty room and bills 1 credit; a handle that does not exist returns 404 at 0 credits. Answers are cached for at most 60 seconds.

Last updated October 2026Maintained by the SocialCrawl team

Start for freeView Documentation

Returns a TikTok account's live room in the platform's own shape: cover image, title, start time, status code, viewer and entry counts, stream ids, and the host's profile.

Use it to read a creator's live room state, but check status and start time yourself, since a room may still be returned after the broadcast has ended.

Searching 68 platforms in parallel

·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
·TikTok logoTikTok·Instagram logoInstagram·YouTube logoYouTube·Facebook logoFacebook·X logoX·LinkedIn logoLinkedIn·Reddit logoReddit·Threads logoThreads·Pinterest logoPinterest·Twitch logoTwitch·Truth Social logoTruth Social·Snapchat logoSnapchat·Kick logoKick·Bluesky logoBluesky·Kwai logoKwai·Rumble logoRumble·Spotify logoSpotify·Apple Music logoApple Music·TikTok Shop logoTikTok Shop·Amazon Shop logoAmazon Shop·Google Shopping logoGoogle Shopping·Trustpilot logoTrustpilot·TripAdvisor logoTripAdvisor·Yelp logoYelp·Linktree logoLinktree·Komi logoKomi·Pillar logoPillar·lnk.bio logolnk.bio·Facebook Ads logoFacebook Ads·Google Ads logoGoogle Ads·LinkedIn Ads logoLinkedIn Ads·Google Search logoGoogle Search·Google News logoGoogle News·Finance logoFinance·Polymarket logoPolymarket·Tavily logoTavily·Hacker News logoHacker News·GitHub logoGitHub·Perplexity logoPerplexity·Naver logoNaver·Utility logoUtility·Universal Search logoUniversal Search
TikTok API

What can you do with the User Live API?

The User Live endpoint gives you structured TikTok data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/user/live?handle=charlidamelio"
import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/tiktok/user/live",
    params={
    'handle': 'charlidamelio',
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()
const response = await fetch(
  "https://www.socialcrawl.dev/v1/tiktok/user/live?handle=charlidamelio",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

Parameters

ParameterRequiredDescription
handleYesTikTok username without the @ symbol
Example Response

What does the TikTok User Live API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response
{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/user/live",
  "data": {
    "is_live": false,
    "liveRoom": {
      "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=56fcdd97&x-expires=1791126000&x-signature=LbU2VeaTrobL41AcsiIxnKl8DLU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "squareCoverImg": "",
      "title": "",
      "startTime": 1781762987,
      "status": 4,
      "paidEvent": {
        "event_id": 0,
        "paid_type": 0
      },
      "liveSubOnly": 0,
      "liveRoomMode": 0,
      "gameTagId": 0,
      "liveRoomStats": {
        "enterCount": 1,
        "userCount": 1
      },
      "streamData": {
        "pull_data": {
          "options": {
            "default_preview_quality": {
              "icon_type": 0,
              "level": 0,
              "name": "user_e3b0c4",
              "resolution": "",
              "sdk_key": "",
              "v_codec": ""
            },
            "default_quality": {
              "icon_type": 0,
              "level": 0,
              "name": "720p",
              "resolution": "",
              "sdk_key": "hd",
              "v_codec": ""
            },
            "forced_low_latency": false,
            "max_drm_lenient_size": "",
            "max_drm_lenient_size_backup": "",
            "qualities": [
              {
                "icon_type": 0,
                "level": 3,
                "name": "720p",
                "resolution": "",
                "sdk_key": "hd",
                "v_codec": ""
              }
            ],
            "show_quality_button": false,
            "support_low_latency": false
          },
          "stream_data": "{\"common\":{\"session_id\":\"173-20261002154045D09C2FEC212F14E00718\",\"room_id\":7652613286029986574,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83502(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"rule_id\\\\\\\":83502,\\\\\\\"rule_name\\\\\\\":\\\\\\\"[TailNumber]FCDN pull FCDN push in US/pct:50\\\\\\\",\\\\\\\"category\\\\\\\":\\\\\\\"Capacity\\\\\\\",\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2041,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\"}}\\\"}\",\"peer_anchor_level\":51,\"default_audio_track\":\"en\"},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd.flv?expire=1792165245&sign=5622ff1075ce70e4ebc4ad3ea0370bc9\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1000000,\\\"resolution\\\":\\\"540x1080\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"cdn77\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd.flv?expire=1792165245&sign=28446850157ee7072a9903bd47f84e7b\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd/index.m3u8?expire=1792165245&sign=764a37111c9bcee83db8a32cc22b7faf\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd/index.mpd?auth_mode=2&expire=1792165245&sign=595017fa3af35c09046c00dea462d2ff\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd.sdp?expire=1792165245&sign=bd20e7c3d91958eb6ba3ffc477a21b9a\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1000000,\\\"resolution\\\":\\\"720x1440\\\",\\\"gop\\\":4}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=6f1542db4760a61dedc6d434ff9cfeba&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"cdn77\\\",\\\"stream_suffix\\\":\\\"ao\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=3095056c6b804592a1f0d7476b49bfd0&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ao/index.mpd?auth_mode=2&expire=1792165245&sign=4a2ce4dc6cf1d732da55eb97f476b94b\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ao\\\"}\"}}}}"
        },
        "push_data": {
          "push_stream_level": 0,
          "resolution_params": {},
          "stream_data": ""
        }
      },
      "streamId": "3578336603596653583",
      "multiStreamScene": 0,
      "multiStreamSource": 0,
      "hevcStreamData": {
        "pull_data": {
          "options": {
            "default_preview_quality": {
              "icon_type": 0,
              "level": 0,
              "name": "user_e3b0c4",
              "resolution": "",
              "sdk_key": "",
              "v_codec": ""
            },
            "default_quality": {
              "icon_type": 0,
              "level": 0,
              "name": "720p",
              "resolution": "",
              "sdk_key": "hd",
              "v_codec": ""
            },
            "forced_low_latency": false,
            "max_drm_lenient_size": "",
            "max_drm_lenient_size_backup": "",
            "qualities": [
              {
                "icon_type": 0,
                "level": 10,
                "name": "Original",
                "resolution": "",
                "sdk_key": "origin",
                "v_codec": ""
              },
              {
                "icon_type": 0,
                "level": 3,
                "name": "720p",
                "resolution": "",
                "sdk_key": "hd",
                "v_codec": ""
              }
            ],
            "show_quality_button": false,
            "support_low_latency": false
          },
          "stream_data": "{\"common\":{\"session_id\":\"173-20261002154045D09C2FEC212F14E00718\",\"room_id\":7652613286029986574,\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_83502(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"category\\\\\\\":\\\\\\\"Capacity\\\\\\\",\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":2041,\\\\\\\"cdn_name\\\\\\\":\\\\\\\"fcdn\\\\\\\",\\\\\\\"rule_id\\\\\\\":83502,\\\\\\\"rule_name\\\\\\\":\\\\\\\"[TailNumber]FCDN pull FCDN push in US/pct:50\\\\\\\"}}\\\"}\",\"peer_anchor_level\":51,\"default_audio_track\":\"en\"},\"data\":{\"hd\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd5.flv?expire=1792165245&sign=5944500a5c0d533388bf1603851634f0\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"stream_suffix\\\":\\\"hd5\\\",\\\"vbitrate\\\":1350000,\\\"resolution\\\":\\\"540x1080\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"cdn77\\\"}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd5.flv?expire=1792165245&sign=1f59024f1e3020f3412807dacd236ccd\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd5/index.m3u8?expire=1792165245&sign=d1ee897eed1d490b367e754a6296b443\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd5/index.mpd?auth_mode=2&expire=1792165245&sign=e95ee747733cedb52700c48ccbc4f912\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_hd5.sdp?expire=1792165245&sign=7fb901041c56c5184270f4388d0b2a23\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"vbitrate\\\":1350000,\\\"resolution\\\":\\\"720x1440\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"hd5\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_zsd5.flv?expire=1792165245&sign=a54f8784b1e1cddc402bd386b3fe987d\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cdn_name\\\":\\\"cdn77\\\",\\\"stream_suffix\\\":\\\"zsd5\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"544x1088\\\",\\\"gop\\\":4}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_zsd5.flv?expire=1792165245&sign=53726a3999cfcbb1d18512562d54198c\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_zsd5/index.m3u8?expire=1792165245&sign=d6432c29c092a1a087a3e217e458b74e\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_zsd5/index.mpd?auth_mode=2&expire=1792165245&sign=a3eb1f7f6ac15e0c893026ec9bfd5b38\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_zsd5.sdp?expire=1792165245&sign=81e2996ff3897a7214a3c455ef9deb01\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"stream_suffix\\\":\\\"zsd5\\\",\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"576x1152\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\"}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=6f1542db4760a61dedc6d434ff9cfeba\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"resolution\\\":\\\"960x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"cdn77\\\",\\\"vbitrate\\\":2824000}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=3095056c6b804592a1f0d7476b49bfd0\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583/index.m3u8?expire=1792165245&sign=924ea1cc326b939b7a834699d6ab11c4\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583/index.mpd?auth_mode=2&expire=1792165245&sign=ce75c5e367c4693249a713d7b7373356\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.sdp?expire=1792165245&sign=e872b66824f3a2c10cc581415a9c7ffd\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"resolution\\\":\\\"960x1920\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"vbitrate\\\":2824000}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=6f1542db4760a61dedc6d434ff9cfeba&only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cdn_name\\\":\\\"cdn77\\\",\\\"stream_suffix\\\":\\\"ao\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583.flv?expire=1792165245&sign=3095056c6b804592a1f0d7476b49bfd0&only_audio=1\",\"hls\":\"\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ao/index.mpd?auth_mode=2&expire=1792165245&sign=4a2ce4dc6cf1d732da55eb97f476b94b\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"fcdn\\\",\\\"stream_suffix\\\":\\\"ao\\\"}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-flv-l77-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ld5.flv?expire=1792165245&sign=37311d006ae9553db8b5d5f23d7f81f2\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"resolution\\\":\\\"360x720\\\",\\\"gop\\\":4,\\\"cdn_name\\\":\\\"cdn77\\\",\\\"stream_suffix\\\":\\\"ld5\\\",\\\"vbitrate\\\":400000}\"},\"backup\":{\"flv\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ld5.flv?expire=1792165245&sign=a5a997485f2d381c935220eda74e05f6\",\"hls\":\"https://pull-hls-f16-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ld5/index.m3u8?expire=1792165245&sign=52da11094c070c4354f267fa10501d2e\",\"cmaf\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ld5/index.mpd?auth_mode=2&expire=1792165245&sign=ec78fba68c9977778566bcb09b51bd51\",\"dash\":\"\",\"lls\":\"https://pull-f5-tt01.tiktokcdn-us.com/stage/stream-3578336603596653583_ld5.sdp?expire=1792165245&sign=2e5926af1d6a27bd28215dccabb41612\",\"tsl\":\"\",\"tile\":\"\",\"rtc\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h265\\\",\\\"cmaf_auth\\\":\\\"auth_mode=2\\\\u0026expire=1792165245\\\\u0026sign=ce75c5e367c4693249a713d7b7373356\\\",\\\"stream_suffix\\\":\\\"ld5\\\",\\\"vbitrate\\\":400000,\\\"resolution\\\":\\\"480x960\\\",\\\"gop\\\":0,\\\"cdn_name\\\":\\\"fcdn\\\"}\"}}}}"
        },
        "push_data": {
          "push_stream_level": 0,
          "resolution_params": {},
          "stream_data": ""
        }
      }
    },
    "liveRoomUserInfo": {
      "avatarLarger": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:1080:1080.webp?dr=9640&refresh_token=90887632&x-expires=1791126000&x-signature=qeLffpNjBQKEgkR0LuDTnFCQDLs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "avatarMedium": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:720:720.webp?dr=9640&refresh_token=b8f3a2b5&x-expires=1791126000&x-signature=ZYelBIQxHyB3Hw%2B8MdPv8vAWAP0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "avatarThumb": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ee31de49ddf64b45c5b2e3c55fbd0ea4~tplv-tiktokx-cropcenter:100:100.webp?dr=9640&refresh_token=226af91a&x-expires=1791126000&x-signature=3wTMz5cffHFj0NJhfqBEgYylLHE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=useast5",
      "id": "5831967",
      "nickname": "charli d’amelio",
      "secUid": "MS4wLjABAAAA-VASjiXTh7wDDyXvjk10VFhMWUAoxr8bgfO1kAL1-9s",
      "secret": false,
      "uniqueId": "charlidamelio",
      "verified": true,
      "roomId": "7652613286029986574",
      "signature": "orca enthusiast\nmeg thee stallion fan\ni post on youtube on saturdays (for the most part)",
      "status": 4,
      "followStatus": 0,
      "followingCount": 1442,
      "followerCount": 160316634
    }
  },
  "credits_used": 1,
  "request_id": "req_example000000",
  "cached": false,
  "credits_remaining": 9999,
  "source": "captured",
  "captured_at": "2026-10-02T15:40:44.238Z",
  "redacted": true
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

API Details

How does the TikTok User Live API work?

Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for TikTok User Live data?

We handle the complexity of TikTok data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 68 platforms covering 10B+ monthly active users.

One schema, every platform

Query 68 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()
[ .JSON ]
{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}
+ 68 platforms
FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
How do I check if a TikTok user is live?
Send a GET request to /v1/tiktok/user/live with the handle parameter (no @ symbol). If the creator is currently streaming, SocialCrawl returns the live stream's viewer count, title, duration, and gift count. If offline, the response indicates no active stream.
What fields does TikTok Live API return?
When a creator is live the response includes stream id, title, viewer_count, duration (seconds since start), gift_count, cover image URL, and start timestamp, all in the analytics schema.
How often can I poll the TikTok Live endpoint?
There are no rate limits. You can poll every few seconds if you are tracking a live event. Each poll costs 1 credit, so use cursor-based polling and back off when the stream metadata stops changing.
Is there a push notification when a TikTok user goes live?
Not yet. /v1/tiktok/user/live is pull-only. To build notifications, poll the endpoint on an interval (for example every 30 seconds) and fire an event when the response shows an active stream.
How much does the TikTok Live API cost?
Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, so you can check a creator's live status around 100 times before paying anything.

Ask AI about SocialCrawl

Ask ChatGPTAsk PerplexityAsk GeminiAsk ClaudeAsk Grok

Ready to scrape TikTok User Live data?

Get your API key and start pulling TikTok data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown