All case studies
Reference deployment 04 / TikTok creators
TikTok Creator Desk: Uploads, Reposts and Live Sessions
A community, brand or research desk needs to know when a public TikTok creator uploads and when one goes live, while the session is still open. This deployment watches creators by @username, routes the five TikTok event types to the team or its own code, and models a live session as a state change rather than a one-off ping.
- Source
- Public TikTok creators, tracked by @username
- Events
- Uploads, reposts, live start and live end, media ready
- Delivery
- REST, WebSocket add-on or the included Discord bot
Evidence basis
This is a reproducible reference deployment based on shipped 1322 behavior. It is not presented as a named-customer testimonial and makes no claim about trading returns. The operating figures below are typical ranges rather than an SLA.
- The TikTok product ships tiktok.upload.created, tiktok.repost.created, tiktok.live.started and tiktok.live.ended under the schema 1322.tiktok.event.v1, plus a sibling tiktok.media.ready frame under 1322.tiktok.media.v1 carrying the downloadable file.
- Live start and live end are separate events carrying the same room_id, which is what allows one alert to be opened and later closed.
- REST and WebSocket use two distinct credentials that are not interchangeable, and the working consumer is published as a Python tutorial.
The operating problem
- No official TikTok developer surface can watch a public creator: each one is scoped to a creator who has connected their own account to the app.
- A live session cannot be caught late; once it ends there is nothing left on the profile to find, so a delayed notification is the wrong notification.
- Tools that fire a single live ping leave stale alerts behind, and a repost flattened into an upload misattributes whose video is actually spreading.
Deployment configuration
- Create a tracked list of the public creators the desk cares about, by @username, over REST, from the dashboard or with the Discord bot.
- Use the included Discord bot when the audience is a channel, and add WebSocket delivery when the desk wants the raw event in its own code.
- Branch on the event type rather than the text: uploads, reposts, live starts, live ends and media-ready each mean something different.
- Key open live sessions by the room_id shared between the start and end events so one session produces one alert.
Event path
- A tracked creator uploads, reposts another creator's video, or opens a live session.
- 1322 converts the source event into the documented TikTok event contract and pushes it on every enabled delivery route.
- The desk posts an alert on tiktok.live.started, holds the message id against the room_id, and closes that same alert when tiktok.live.ended arrives.
- When a tracked video's file becomes fetchable, tiktok.media.ready carries the media URL so an archiving worker makes one request instead of a retry loop.
What changes operationally
- A watchlist replaces a set of profiles someone was refreshing by hand, and live sessions surface while they are still open.
- Reposts keep their original author, so the desk can see whose video is spreading rather than crediting the creator who shared it.
- TikTok runs on the same account and event vocabulary as the desk's other sources, so adding it does not mean a second vendor or a second integration.
Limits and decisions
- TikTok delivery is described as sub-second in typical operation; that is an operating range, not an SLA, and no per-account millisecond figure is promised.
- This deployment monitors public creators only, and the feed is real-time with no historical backfill or queued replay while a client is disconnected.
- It is an event source, not an analytics suite: there is no follower reporting, engagement benchmarking or content-performance dashboard.