Unofficial TikTok Live Recorder API — Recordings
GET/api/v1/recorder_recordings
List the live recordings captured for the accounts your key tracks, newest first. Optionally filter by a tracked username.
| Parameter | Description | |
|---|---|---|
username | optional | Limit to one tracked username. Omit for all. |
limit | optional | Max rows to return (1-500). Omit for all. |
offset | optional | Rows to skip (for pagination). Default 0. |
key | required | Your API key (query ?key=, ?api_key=, or header X-API-Key). |
Returns
count (returned), total (all matching), limit, offset, and recordings — each with a signed thumb_url, expires_at, room_id, and part/part_count (segments of one broadcast, same room_id, split on a CDN drop — group by room_id, order by part). events_url (when present) is the synced chat + gift track: JSONL, one event per line, each with t = ms from the start of the video.
Example Request
https://dev.omar-thing.site/api/v1/recorder_recordings?username=purrglitter&limit=50&offset=0&key=YOUR_API_KEY&key=YOUR_API_KEY
Sends a live request using your API key above.
More Other endpoints
- Unofficial TikTok Live Recorder API — Manage the accounts your key tracks for auto-recording. GET lists them (with live status); POST {username} adds one (up to your limit); DELETE {username} stops tracking one.
- Unofficial TikTok Live Recorder API — Keep a recording permanently (bookmark) so retention never deletes it, or clear the bookmark.
valuedefaults to true. - Unofficial TikTok Live Recorder API — Get a temporary signed URL to play one of your recordings (video + thumbnail). Links expire after an hour.