TikTok Public LIVE Room Metadata

Resolve public TikTok LIVE room metadata for usernames or canonical LIVE URLs. The Actor first tries tiktok-live-connector room information and then falls back to the public LIVE page and its embedded state when needed.

This implementation is metadata-only. It does not subscribe to a LIVE event stream and does not collect chat messages, gifts, likes, follows, joins, shares, or real-time stats.

Example input

{
  "usernames": ["officialgeilegisela"],
  "maxUsers": 1,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

You can provide usernames, canonical URLs such as https://www.tiktok.com/@creator/live, or both. Duplicate broadcasters are removed.

Example output

{
  "recordType": "tiktok-live-room-info",
  "status": "success",
  "dataAvailable": true,
  "source": "tiktok.com",
  "provenance": "public_tiktok_live_room",
  "sourceTransport": "tiktok-live-connector",
  "extractionMethod": "connector_room_info",
  "sourceUrl": "https://www.tiktok.com/@creator/live",
  "hostUsername": "creator",
  "roomId": "1234567890",
  "liveTitle": "Public LIVE title",
  "liveStatus": 2,
  "currentViewers": 1200,
  "eventStreamAvailable": false,
  "eventStreamStatus": "room-info-route",
  "scrapedAt": "2026-08-18T00:00:00.000Z"
}

If the broadcaster is offline, the page is blocked, or no room state is public, the dataset receives a diagnostic record. The OUTPUT summary reports success, partial, or failed status.

Input

• usernames (array): Public TikTok usernames without @.
• liveUrls (array): Public HTTPS TikTok LIVE URLs.
• maxUsers (integer, 1–5): Maximum unique broadcasters to process. Default: 5.
• proxyConfiguration (object, optional): Apify Proxy configuration for public page fallback requests. The connector room-info request uses its own HTTP client.

At least one of usernames or liveUrls is required.

Output and storage

Room metadata and diagnostics are written to the default dataset. The Output tab links to the dataset and to OUTPUT in the default key-value store.

OUTPUT contains requested and processed broadcaster counts, metadata count, diagnostic count, failed usernames, and the explicit event-stream limitation.

Limitations and cost

Room availability is time-dependent: an offline broadcaster may produce an access diagnostic even when the username is valid. Public page state and connector behavior can change as TikTok updates its web client. The Actor does not maintain a persistent socket or collect events after room metadata is resolved.

Connector requests, public HTTP fallback requests, Apify compute, and optional proxy traffic contribute to cost. Keep maxUsers small while testing and retry responsibly.

FAQ and disclaimer

Does this Actor collect LIVE chat or gifts?

No. It only resolves public room metadata and sets eventStreamAvailable to false.

Why did I receive an offline diagnostic?

The broadcaster may not be live, or TikTok may have returned a page without public room state. Review accessStatus, httpStatus, and the bounded body sample.

Does it use private account cookies or bypass blocks?

No. It does not log in, defeat CAPTCHAs, or bypass private-account controls.

Use public data for a legitimate purpose, follow TikTok terms and robots guidance, and review privacy and data-protection obligations. For support, use the Actor Issues tab.