Fields Reference · TikTok Insights
TikTok Insights Fields List
90 fields · 0 dimensions · 0 metrics · 7 groups
| Field name | Label | Category | Description |
|---|---|---|---|
date | Date | Time | The specific date in the format YYYY-MM-DD. |
day_of_week | Day of Week | Time | The name of the day of the week, e.g., MONDAY. |
hour | Hour | Time | The hour of the day as a number between 0 and 23. |
month | Month | Time | The month in the format MM or its name, e.g., JANUARY. |
quarter | Quarter | Time | Quarter in the format Q, e.g., Q1. |
week | Week | Time | The week starting on Monday, represented by the date of the Monday. |
year | Year | Time | The year in the format YYYY. |
year_month | Year-Month | Time | The year and month in the format YYYY-MM. |
year_quarter | Year-Quarter | Time | The year and quarter in the format YYYY-Q, e.g., 2024-Q1. |
year_week | Year-Week | Time | The year and week starting on Monday, represented by the date of the Monday. |
full_video_watched_rate | Video Full Watched Rate | Video Performance | Percentage of viewers who viewed the whole video. |
impression_source | Impression Source | Video Performance | Impression Source |
video_address_clicks | Video Address Clicks | Video Performance | The total number of times people have clicked the Address button on your profile after watching this specific video. |
video_app_download_clicks | Video App Download Clicks | Video Performance | The total number of clicks on your app download link from users who visited your profile page through your video. |
video_audience_cities | Video Audience Cities | Video Performance | The distribution of your viewers by the top cities. This data is based on factors including the information viewers provide. |
video_audience_countries | Video Audience Countries | Video Performance | Country distribution of video viewers for the top 10 countries. |
video_audience_genders | Video Audience Genders % | Video Performance | The distribution of your viewers by gender. This data is based on factors including the information viewers provide. |
video_audience_types | Video Audience Types | Video Performance | Viewer types. The breakdown of your audience into new viewers versus returning viewers, and followers versus non-followers. |
video_audience_types_percentage | Video Audience Types % | Video Performance | The breakdown of your audience into new viewers versus returning viewers, and followers versus non-followers. |
video_average_time_watched | Video Average Time Watched | Video Performance | Average watch-time for the video across all views. |
video_comments | Video Comments | Video Performance | The total number of comments the video has received. |
video_email_clicks | Video Email Clicks | Video Performance | The total number of times people have clicked the Email button on your profile after watching this specific video. |
video_engagement_likes | Video Engagement Likes % | Video Performance | The distribution of your viewers who liked your video at specific points in the video’s timeline. |
video_engagements | Video Engagements | Video Performance | The total number of likes, shares, comments the video has received. |
video_favorites | Video Favorites | Video Performance | The total number of times the video has been added to favorites. |
video_impression_sources | Video Impression Sources Percentage | Video Performance | Source of video view. |
video_lead_submissions | Video Lead Submissions | Video Performance | The total number of leads (e.g. price quotes, newsletter subscriptions, etc.) collected from your consumers who visited your profile page through your video. |
video_likes | Video Likes | Video Performance | The total number of likes the video has received. |
video_new_followers | Video New Followers | Video Performance | The number of viewers who started following you. |
video_phone_number_clicks | Video Phone Number Clicks | Video Performance | The total number of clicks on your phone number link from users who visited your profile page through your video. |
video_profile_views | Video Profile Views | Video Performance | The total number of profile views from users who visited through your video. |
video_reach | Video Reach | Video Performance | Total number of unique viewers who viewed the video. |
video_shares | Video Shares | Video Performance | The total number of times the video has been shared. |
video_specific_second | Video Seconds Timeline | Video Performance | A specific second in the video’s timeline. |
video_total_time_watched | Video Total Time Watched | Video Performance | Total watch-time for the video across all views. |
video_view_retention_percentage | Video View Retention % | Video Performance | This metric indicates how many of your viewers are still watching after a certain amount of time. |
video_views | Video Views | Video Performance | The total number of views the video has received. |
video_website_clicks | Video Website Clicks | Video Performance | The total number of clicks on your website link from users who visited your profile page through your video. |
address_clicks | Profile Address Clicks | Profile Performance | Daily address clicks. The daily number of clicks collected on the Address button on your profile during the selected time range. |
app_download_clicks | Profile App Download Clicks | Profile Performance | Daily app download link clicks. The daily number of clicks collected on your app download link in the selected date range. |
bio_link_clicks | Profile Bio Link Clicks | Profile Performance | Daily bio link clicks. The daily number of clicks collected on your link-in-bio during the selected time range. |
comments | Profile Comments | Profile Performance | The daily number of comments received across the TikTok account’s videos. |
daily_lost_followers | Profile Lost Followers | Profile Performance | Daily lost followers. The daily number of followers you have lost. |
daily_new_followers | Profile New Followers | Profile Performance | Daily new followers. The daily number of new followers you have gained. |
daily_total_followers | Profile Net Followers Growth | Profile Performance | Daily net growth. The daily change in the number of followers. |
email_clicks | Profile Email Clicks | Profile Performance | Daily email clicks. The daily number of clicks collected on the Email button on your profile during the selected time range. |
engaged_audience | Profile Engaged Audience | Profile Performance | Daily engaged audience. The daily number of people who engaged (liked, commented or shared) with at least one of your published content. |
followers_count | Total Followers | Profile Performance | The number of followers for the TikTok account. |
following_count | Profile Follows | Profile Performance | The lifetime number of accounts that the TikTok account is following. |
lead_submissions | Profile Lead Submissions | Profile Performance | Daily lead submissions. The daily number of leads (e.g. price quotes, newsletter subscriptions, etc.) collected from your consumers in the selected date range. |
likes | Profile Likes | Profile Performance | The daily number of likes received across the TikTok account’s videos. |
phone_number_clicks | Profile Phone Number Clicks | Profile Performance | Daily phone number clicks. The daily number of clicks collected on your phone number link in the selected date range. |
profile_unique_video_views | Profile Unique Video Views | Profile Performance | Daily reached audience. The daily number of people who watched your published content at least once. |
profile_video_views | Profile Video Views | Profile Performance | Daily video views. The daily number of times your videos have been viewed. |
profile_views | Profile Views | Profile Performance | The daily number of times the TikTok account’s profile has been viewed. |
shares | Profile Shares | Profile Performance | The daily number of times the TikTok account’s videos have been shared. |
total_likes | Profile Total Likes | Profile Performance | The lifetime number of likes received across the TikTok account’s videos. |
videos_count | Profile Post Count | Profile Performance | The lifetime number of public videos posted by the TikTok account. |
age | Age | Profile Followers | Age |
audience_activity_count | Profile Followers Activity | Profile Followers | The daily number of followers online in each hour of the day. This metric should be used in conjunction with the hour dimension for accurate analysis. |
audience_age_percentage | Followers Age | Profile Followers | Follower age. The distribution of your followers by age. This demographic data is based on a number of factors, including information users provide in their profiles. (The data for this metric is only available for TikTok accounts with at least 100 followers). |
audience_ages_percentage | Followers Age % | Profile Followers | Follower age. The distribution of your followers by age. This demographic data is based on a number of factors, including information users provide in their profiles. (The data for this metric is only available for TikTok accounts with at least 100 followers). |
audience_cities_percentage | Followers City % | Profile Followers | Follower top cities. The distribution of your followers by their cities. This demographic data is based on a number of factors, including information users provide in their profiles. (The data for this metric is only available for TikTok accounts with at least 100 followers). |
audience_countries_percentage | Followers Country % | Profile Followers | Country distribution of the TikTok account’s followers. (The data for this metric is only available for TikTok accounts with at least 100 followers). |
audience_genders_percentage | Followers Gender % | Profile Followers | Gender distribution of the TikTok account’s followers. |
city | City | Profile Followers | City |
country | Country | Profile Followers | Country |
country_code | Country Code | Profile Followers | Country Code |
country_icon | Country Icon | Profile Followers | Country icon |
country_icon_url | Country Icon Url | Profile Followers | Country icon url |
gender | Gender | Profile Followers | Gender |
gender_icon | Gender Icon | Profile Followers | Gender icon |
gender_icon_url | Gender Icon Url | Profile Followers | Gender icon url |
bio_description | Profile Bio Description | Profile Details | The bio description of the TikTok account. |
display_name | Profile Name | Profile Details | The display name of the TikTok account. |
is_business_account | Is Business Profile | Profile Details | Whether the TikTok account is a TikTok Business Profile. |
is_verified | Is Verified | Profile Details | Whether TikTok has provided a verified badge to the TikTok account after confirming that it belongs to the user it represents. |
profile_deep_link | Profile Link | Profile Details | The link to the profile page of the TikTok account. |
profile_image | Profile Image | Profile Details | Profile image of the TikTok account. |
profile_image_url | Profile Image URL | Profile Details | The URL to the profile image of the TikTok account. |
username | Profile Username | Profile Details | The username of the TikTok account. |
video_caption | Video Caption | Video Details | The caption/description for the video. |
video_create_time | Video Create Time | Video Details | Unix/epoch date-time when the video was posted. |
video_duration | Video Duration | Video Details | Duration of the video, in seconds. |
video_embed_url | Video Embed URL | Video Details | An embeddable URL for the video. |
video_id | Video ID | Video Details | Unique identifier for the video. |
video_share_url | Video Share URL | Video Details | A shareable URL for the video. |
video_thumbnail | Video Thumbnail | Video Details | Video thumbnail. |
video_thumbnail_url | Video Thumbnail URL | Video Details | Preview thumbnail for the video. |
business_id | Unique ID of the TikTok Profile | Profile ID | Application specific unique ID of the TikTok account. |