TikTok Live API

Check whether a creator is currently live

Check the public live status of a TikTok creator and return the exposed room ID when available.

1 CreditCost
Live StatusOutput
Username or URLInput

Quick Start

Get started with a simple API call.

const response = await fetch('https://api.crawlkit.sh/v1/crawl/tiktok/live', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "username": "khaby.lame",
  "options": {
    "timeout": 30000
  }
})
});

const { data } = await response.json();
console.log(data.live.isLive, data.live.roomId);

Key Features

Everything you need for reliable tiktok live workflows.

Live Status

Returns a direct boolean flag for whether the creator is currently live.

Room Identifier

Includes the exposed room ID when TikTok surfaces it publicly.

Fast Polling Pattern

Useful for periodic live checks in monitoring and alerting systems.

How It Works

Get started in minutes with our simple API.

1

Get Your API Key

Sign up for free and get your API key instantly. No credit card required.

2

Make Your First Request

Use our simple REST API with your favorite programming language.

3

Get Structured Data

Receive clean JSON responses ready to use in your application.

API Response

Get clean, structured JSON data with every request. Our API returns comprehensive data including status codes, timing information, and your remaining credits.

  • Consistent JSON structure
  • Detailed timing metrics
  • Credit usage tracking
  • Error handling built-in
Response
{
  "success": true,
  "data": {
    "live": {
      "username": "khaby.lame",
      "title": "khaby.lame LIVE | TikTok",
      "isLive": false,
      "roomId": null,
      "checkedAt": 1774860112421
    },
    "timing": {
      "total": 1948
    },
    "creditsUsed": 1,
    "creditsRemaining": 88
  }
}

Use Cases

Common applications for TikTok Live.

Live Alerts

Trigger notifications when monitored creators go live.

Scheduling Tools

Check live state before refreshing dashboards or campaign panels.

Creator Monitoring

Keep a simple live heartbeat across tracked accounts.

Frequently Asked Questions

Everything you need to know about the TikTok Live API.

No. This endpoint is focused on public live state detection plus the exposed room identifier.

You can send khaby.lame, @khaby.lame, or the full TikTok profile URL.

TikTok Live uses 1 credit per request.

Start Using TikTok Live API Today

Get 100 free credits to test the API. No credit card required.