Skip to main content
Checks a TikTok user’s live status and retrieves available live room details.
Tool ID: scrapecreators_tiktok_user_live

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

CLI

Example response

The static output schema lacks the details for a reliable example. Use deepline describe scrapecreators_tiktok_user_live --json for the complete live contract.

Input reference

Checks a TikTok user’s live status and retrieves available live room details. First checks the account with the same profile lookup used by /v1/tiktok/profile. This does not add a second API credit charge. Active streams return HTTP 200 with is_live: true. An existing account that is offline or has no current stream returns HTTP 200 with is_live: false. Unavailable accounts: HTTP 404 when TikTok confirms the account is not found or unavailable. Audience controls: HTTP 403 when TikTok confirms the creator enabled them, with TikTok’s login warning. Retrieval failures: HTTP 500 when the live check fails. A failed check is not evidence that the account is offline, and having no current stream is not an account-not-found error. Use the top-level is_live boolean instead of checking TikTok’s numeric status values yourself. Available details include liveRoomUserInfo (nickname, avatar, See the live schema below for the complete notes.

Output reference

Standard tool result payload.

Deepline cost

  • Pricing model: fixed (per call).
  • Estimated Deepline credits: 0.02 per pricing unit.