TikTok
Live Room
Checks whether a TikTok creator is currently live and returns room ID, title, start time, current and peak viewer counts, and stream cover art. Useful for live-commerce monitoring and alerting when a tracked creator goes on air.
What you get
Each call returns one live room record. There is no pagination.
Endpoint
GET /v1/tiktok/live-room
Price
$1.50
per 1,000 calls · $0.0015 per call
Cost per call
1 credit
Failed calls never charged
Parameters
The TikTok handle, URL or identifier to resolve.
Maximum records to return, capped at this service's page size (see Limits below). Omit it to receive the whole page. It shapes the response, not the price — a call costs the same either way.
Pagination cursor returned by a previous response.
Bypass cached data and force a live fetch for this one call. Use it for daily monitoring or any figure you are tracking over time. Accepts `true`, `1`, `false` or `0`; anything else returns 400 `invalid_fresh`. Defaults to false and costs exactly the same as a cached call.
One of: true, 1, false, 0
Example request
Live call. Successful calls are charged; failed and empty results are not.
curl "https://fastfetchz.com/v1/tiktok/live-room?target=nasa" \
-H "X-API-Key: $FASTFETCHZ_KEY"Example response
{
"success": true,
"service": {
"platform": "TikTok",
"name": "Live Room",
"slug": "live-room"
},
"credits_charged": 1,
"credits_remaining": 99,
"latency_ms": 214,
"data": {
"items": [
{
"id": "7000345014",
"shortcode": "S7E7Q",
"url": "https://example.com/tiktok/nasa/345014",
"caption": "Sandbox live room item #1 for @nasa.",
"media_type": "image",
"like_count": 25214,
"comment_count": 319,
"view_count": 346014,
"duration_sec": 56,
"taken_at": "2026-10-15T21:20:58.035Z"
},
{
"id": "7000323451",
"shortcode": "S6XKR",
"url": "https://example.com/tiktok/nasa/323451",
"caption": "Sandbox live room item #2 for @nasa.",
"media_type": "image",
"like_count": 3651,
"comment_count": 356,
"view_count": 324451,
"duration_sec": 93,
"taken_at": "2026-10-14T21:20:58.035Z"
}
],
"paging": {
"has_more": true,
"next_cursor": "cursor_40643"
}
}
}Limits
- Maximum per call: 1 live rooms.
- Minimum per call: 1 live room — a target with less data returns fewer live rooms, and an empty result is still a successful call.
- Each call fetches a full page of up to 1 and costs the same either way. Pass limit to receive fewer than that in the response.
- This endpoint returns a single record per call and is not paginated.
What this costs in practice
10,000 live rooms = 10,000 calls × 1 credits per call = 10,000 credits = $0.00
Priced at the Custom pack rate: 1,000,000 credits for $0.00.
Open in the pricing calculator