Docs
TikTok Fields Fields List
Complete reference of all 90 fields available in the TikTok connector.
TikTok
31 Metrics59 Dimensions
The TikTok connector provides 90 fields. Metrics (31) measure performance. Dimensions (59) provide context for segmentation.
| Field Name | Type | Category | Group | Description |
|---|---|---|---|---|
|
Profile Address Clicks
|
Number | Metric | Profile Performance | Daily address clicks. The daily number of clicks collected on the Address button on your profile during the selected time range. |
|
Age
|
Number | Metric | Profile Followers | Age |
|
Profile App Download Clicks
|
Number | Metric | Profile Performance | Daily app download link clicks. The daily number of clicks collected on your app download link in the selected date range. |
|
Profile Followers Activity
|
Number | Metric | 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. |
|
Followers Age
|
Number | Metric | 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). |
|
Followers Age %
|
Number | Metric | 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). |
|
Followers City %
|
Number | Metric | 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). |
|
Followers Country %
|
Number | Metric | 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). |
|
Followers Gender %
|
Number | Metric | Profile Followers | Gender distribution of the TikTok account’s followers. |
|
Profile Bio Description
|
Number | Metric | Profile Details | The bio description of the TikTok account. |
|
Profile Bio Link Clicks
|
Number | Metric | Profile Performance | Daily bio link clicks. The daily number of clicks collected on your link-in-bio during the selected time range. |
|
Unique ID of the TikTok Profile
|
String | Dimension | Profile Id | Application specific unique ID of the TikTok account. |
|
City
|
String | Dimension | Profile Followers | City |
|
Profile Comments
|
Number | Metric | Profile Performance | The daily number of comments received across the TikTok account’s videos. |
|
Country
|
String | Dimension | Profile Followers | Country |
|
Country Code
|
String | Dimension | Profile Followers | Country Code |
|
Country Icon
|
String | Dimension | Profile Followers | Country icon |
|
Country Icon Url
|
String | Dimension | Profile Followers | Country icon url |
|
Profile Lost Followers
|
Number | Metric | Profile Performance | Daily lost followers. The daily number of followers you have lost. |
|
Profile New Followers
|
Number | Metric | Profile Performance | Daily new followers. The daily number of new followers you have gained. |
|
Profile Net Followers Growth
|
Number | Metric | Profile Performance | Daily net growth. The daily change in the number of followers. |
|
Date
|
Date | Dimension | Time | The specific date in the format YYYY-MM-DD. |
|
Day of Week
|
Date | Dimension | Time | The name of the day of the week, e.g., MONDAY. |
|
Profile Name
|
String | Dimension | Profile Details | The display name of the TikTok account. |
|
Profile Email Clicks
|
String | Dimension | Profile Performance | Daily email clicks. The daily number of clicks collected on the Email button on your profile during the selected time range. |
|
Profile Engaged Audience
|
Number | Metric | Profile Performance | Daily engaged audience. The daily number of people who engaged (liked, commented or shared) with at least one of your published content. |
|
Total Followers
|
Number | Metric | Profile Performance | The number of followers for the TikTok account. |
|
Profile Follows
|
Number | Metric | Profile Performance | The lifetime number of accounts that the TikTok account is following. |
|
Video Full Watched Rate
|
String | Dimension | Video Performance | Percentage of viewers who viewed the whole video. |
|
Gender
|
Number | Metric | Profile Followers | Gender |
|
Gender Icon
|
Number | Metric | Profile Followers | Gender icon |
|
Gender Icon Url
|
String | Dimension | Profile Followers | Gender icon url |
|
Hour
|
Date | Dimension | Time | The hour of the day as a number between 0 and 23. |
|
Impression Source
|
Number | Metric | Video Performance | Impression Source |
|
Is Business Profile
|
Number | Metric | Profile Details | Whether the TikTok account is a TikTok Business Profile. |
|
Is Verified
|
Number | Metric | Profile Details | Whether TikTok has provided a verified badge to the TikTok account after confirming that it belongs to the user it represents. |
|
Profile Lead Submissions
|
Number | Metric | 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. |
|
Profile Likes
|
Number | Metric | Profile Performance | The daily number of likes received across the TikTok account’s videos. |
|
Month
|
Date | Dimension | Time | The month in the format MM or its name, e.g., JANUARY. |
|
Profile Phone Number Clicks
|
Number | Metric | Profile Performance | Daily phone number clicks. The daily number of clicks collected on your phone number link in the selected date range. |
|
Profile Link
|
Number | Metric | Profile Details | The link to the profile page of the TikTok account. |
|
Profile Image
|
Number | Metric | Profile Details | Profile image of the TikTok account. |
|
Profile Image URL
|
String | Dimension | Profile Details | The URL to the profile image of the TikTok account. |
|
Profile Unique Video Views
|
String | Dimension | Profile Performance | Daily reached audience. The daily number of people who watched your published content at least once. |
|
Profile Video Views
|
String | Dimension | Profile Performance | Daily video views. The daily number of times your videos have been viewed. |
|
Profile Views
|
Number | Metric | Profile Performance | The daily number of times the TikTok account’s profile has been viewed. |
|
Quarter
|
Date | Dimension | Time | Quarter in the format Q, e.g., Q1. |
|
Profile Shares
|
Number | Metric | Profile Performance | The daily number of times the TikTok account’s videos have been shared. |
|
Profile Total Likes
|
Number | Metric | Profile Performance | The lifetime number of likes received across the TikTok account’s videos. |
|
Profile Username
|
String | Dimension | Profile Details | The username of the TikTok account. |
|
Video Address Clicks
|
String | Dimension | 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
|
String | Dimension | 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
|
String | Dimension | 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
|
String | Dimension | Video Performance | Country distribution of video viewers for the top 10 countries. |
|
Video Audience Genders %
|
String | Dimension | Video Performance | The distribution of your viewers by gender. This data is based on factors including the information viewers provide. |
|
Video Audience Types
|
String | Dimension | Video Performance | Viewer types. The breakdown of your audience into new viewers versus returning viewers, and followers versus non-followers. |
|
Video Audience Types %
|
String | Dimension | Video Performance | The breakdown of your audience into new viewers versus returning viewers, and followers versus non-followers. |
|
Video Average Time Watched
|
String | Dimension | Video Performance | Average watch-time for the video across all views. |
|
Video Caption
|
String | Dimension | Video Details | The caption/description for the video. |
|
Video Comments
|
String | Dimension | Video Performance | The total number of comments the video has received. |
|
Video Create Time
|
String | Dimension | Video Details | Unix/epoch date-time when the video was posted. |
|
Video Duration
|
String | Dimension | Video Details | Duration of the video, in seconds. |
|
Video Email Clicks
|
String | Dimension | Video Performance | The total number of times people have clicked the Email button on your profile after watching this specific video. |
|
Video Embed URL
|
String | Dimension | Video Details | An embeddable URL for the video. |
|
Video Engagement Likes %
|
String | Dimension | Video Performance | The distribution of your viewers who liked your video at specific points in the video’s timeline. |
|
Video Engagements
|
String | Dimension | Video Performance | The total number of likes, shares, comments the video has received. |
|
Video Favorites
|
String | Dimension | Video Performance | The total number of times the video has been added to favorites. |
|
Video ID
|
String | Dimension | Video Details | Unique identifier for the video. |
|
Video Impression Sources Percentage
|
String | Dimension | Video Performance | Source of video view. |
|
Video Lead Submissions
|
String | Dimension | 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
|
String | Dimension | Video Performance | The total number of likes the video has received. |
|
Video New Followers
|
String | Dimension | Video Performance | The number of viewers who started following you. |
|
Video Phone Number Clicks
|
String | Dimension | 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
|
String | Dimension | Video Performance | The total number of profile views from users who visited through your video. |
|
Video Reach
|
String | Dimension | Video Performance | Total number of unique viewers who viewed the video. |
|
Video Share URL
|
String | Dimension | Video Details | A shareable URL for the video. |
|
Video Shares
|
String | Dimension | Video Performance | The total number of times the video has been shared. |
|
Video Seconds Timeline
|
String | Dimension | Video Performance | A specific second in the video’s timeline. |
|
Video Thumbnail
|
String | Dimension | Video Details | Video thumbnail. |
|
Video Thumbnail URL
|
String | Dimension | Video Details | Preview thumbnail for the video. |
|
Video Total Time Watched
|
String | Dimension | Video Performance | Total watch-time for the video across all views. |
|
Video View Retention %
|
String | Dimension | Video Performance | This metric indicates how many of your viewers are still watching after a certain amount of time. |
|
Video Views
|
String | Dimension | Video Performance | The total number of views the video has received. |
|
Video Website Clicks
|
String | Dimension | Video Performance | The total number of clicks on your website link from users who visited your profile page through your video. |
|
Profile Post Count
|
String | Dimension | Profile Performance | The lifetime number of public videos posted by the TikTok account. |
|
Week
|
Date | Dimension | Time | The week starting on Monday, represented by the date of the Monday. |
|
Year
|
Date | Dimension | Time | The year in the format YYYY. |
|
Year-Month
|
Date | Dimension | Time | The year and month in the format YYYY-MM. |
|
Year-Quarter
|
Date | Dimension | Time | The year and quarter in the format YYYY-Q, e.g., 2024-Q1. |
|
Year-Week
|
Date | Dimension | Time | The year and week starting on Monday, represented by the date of the Monday. |