TikTok LIVE Room Status & Chat Capture Tool

What it returns

14 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• recordType
• isLive
• status
• hostUsername
• liveTitle
• currentViewers
• eventType
• receivedAt
• totalViewers
• startedAt
• hostFollowerCount
• liveUrl
• user
• payload

Not in the schema among the core TikTok fields: video_id, caption, author, likes, comments, shares, posted_at. The field matrix shows which other tools return them.

How it differs from the other TikTok Actors

Among the 17 catalogue Actors for TikTok with a published schema, only this one returns isLive, liveTitle, currentViewers, eventType, receivedAt, totalViewers, startedAt, liveUrl.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "mode": "roomStatus",
  "usernames": [
    "natgeo"
  ],
  "includeOffline": true,
  "includeStreamUrls": true,
  "connectionDuration": 10,
  "eventCap": 100,
  "eventTypes": [
    "all"
  ]
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "roomStatus",
    "usernames": [
        "natgeo"
    ],
    "includeOffline": True,
    "includeStreamUrls": True,
    "connectionDuration": 10,
    "eventCap": 100,
    "eventTypes": [
        "all"
    ]
}

run = client.actor("nimbryxo-studio/tiktok-live-room-status-and-chat-capture-tool").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "roomStatus",
    "usernames": [
        "natgeo"
    ],
    "includeOffline": true,
    "includeStreamUrls": true,
    "connectionDuration": 10,
    "eventCap": 100,
    "eventTypes": [
        "all"
    ]
};

const run = await client.actor("nimbryxo-studio/tiktok-live-room-status-and-chat-capture-tool").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~tiktok-live-room-status-and-chat-capture-tool/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"roomStatus","usernames":["natgeo"],"includeOffline":true,"includeStreamUrls":true,"connectionDuration":10,"eventCap":100,"eventTypes":["all"]}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/tiktok-live-room-status-and-chat-capture-tool",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among TikTok routes

It ranks 16 of 17 catalogue Actors for TikTok on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

TikTok LIVE records provide creator status, room titles, viewer counts and host details, or captured events with eventType, receivedAt, user and payload. Choose it for checking who is live or collecting activity during a stream; the catalogue's TikTok search, mention and post-detail tools focus on published posts.

Supply mode to choose room status collection or live event capture.

• Maintain a creator watchlist using hostUsername, isLive and status.
• Compare currentViewers, totalViewers and hostFollowerCount across live creators.
• Group captured chat, gift and like activity by eventType and receivedAt for stream analysis.
• check live stream status
• capture live chat
• collect stream events

Tips

• Batch bare usernames, handles, profile links or LIVE links in usernames; duplicates are removed.
• Use eventTypes to retain the event categories relevant to your analysis in live events mode.

Other catalogue Actors for TikTok

Similar Actors

Questions people ask

Sources

• TikTok LIVE Room Status & Chat Capture Tool on Apify Store
• Published build with input and output schema (JSON)
• TikTok APIs documentation