📡 Datasource Capabilities
An overview of TikTok Managed Account data source capabilities.
TikTok Managed Account
Source: Official TikTok API
Post types: Account Posts.
Post Content formats: Video, Image
Engagement types: Comments, Replies, Post Mentions, Comment Mentions
Data Latency
My Posts: Every 3 Hours “Posts are fetched every 3 hours, but if a comment appears before the next fetch, the related post is retrieved immediately”
Comments & Replies: Near Realtime ( sometimes TikTok takes 5-15 minutes to review )
Post Mentions & Comment Mentions: 2–3 hours
Historical Data Access:
Backfill Coverage: 2 Years
Post types: Account Posts ( Video, Image )
Engagement types: Comments & Replies.
Metrics Availability:
TikTok makes historical backfill data available for up to 60 days prior to the API request time for Account Metrics ( Daily Total Followers, Daily New Followers, Daily Lost Followers )
For Posts Metrics:
When historical posts are retrieved, the latest available metrics are fetched.
If a post was created within 30 days before the historical request, its metrics will continue to be updated for the remainder of the 30-day period from the post creation date.
Example:
If a post was created on 10 March and the historical request is made on 15 March, the post metrics will continue to be updated for the next 25 days
📊 Data Dictionary & Engagement Metrics Refresh Rate
Understand the TikTok data that Lucidya collects and how often metrics are refreshed.
Entity | Description | Metadata | Metrics | Metrics Refresh Rate | Duration |
Account | The owned TikTok account being monitored | Account username, Account display name | Total Posts, Total Engagements, Total Views, Total Reach, Total Likes, Profile Visits, Audience Type, Daily Total Followers, Daily New Followers, Daily Lost Followers | Every 3 hours (Likes, Followers, Following, Total Posts) / Once per day for all other metrics — TikTok has a 24–48 hour latency for daily metrics | Forever |
My Post (Image / Video) | Content published by the account owner | Post content, Post permalink, Creation date & time, Media (Photos, Videos) | Likes, Shares, Comments, Favorites, Views, Profile Visits, New Followers From Post, Video Analytics: Video Completion Rate, Average Watch Time, Total Time Watched, Video Views, Unique Views | Once per day — TikTok has a 24–48 hour latency | 30 days |
Engagements to My Account (Comments, Replies) | User engagements on posts published by the account owner | Author profile image, Author name & username, Post permalink, Post content, Creation date & time, Media (Photos), Post Mentioned, Comment Mentioned | — | — | — |
Mentions (Post Mentions & Comment Mentions) | Mentions of the owned account in posts or comments | Author username, Post permalink, Creation date & time, Media (Photos), Post Mentioned, Comment Mentioned | — | — | — |
Author / Engager | Profile information for users who post, engage with, or mention the owned account | Profile URL, Profile image, Name & username | — | — | — |
How to Set Up:
To set up a Tik Tok managed account monitor, refer to this guide: Creating a Managed Account Monitor.
⚠️ Creating a Managed Account Monitor is only available for TikTok Business Accounts. Make sure your account is set to Business before connecting it to Lucidya.