Public TikTok data · GET endpoint

TikTok Live API

Whether a creator is live right now, with viewers and title. This supported crawlfeed endpoint returns LiveStream in the shared data and meta response envelope.

1 credit / standard callReturns LiveStream

Request

Send an authorized GET request to this route. The values in the examples are starting points; replace them with the public TikTok item or query you want to read.

GET /v1/tiktok/live

Parameters

NameUseWhat it controls
handleRequiredUsername without the @, or the profile URL.
freshOptionalSkip the cache. Costs double.

You can also pass include_raw=true to include the source payload. Read response format details.

Copy a working request

Set CRAWLFEED_KEY to your API key. The live operation costs 1 credit at the standard rate; fresh=true skips cache and doubles the cost.

curl -G https://api.crawlfeed.dev/v1/tiktok/live \
  -H "Authorization: Bearer $CRAWLFEED_KEY" \
  --data-urlencode "handle=charlidamelio"

What happens next?

Use the normalized LiveStream value from data in your application, and inspect meta for credits, source and pagination. The type reference lists fields. Public data availability can vary by item and platform.

Related TikTok calls