TikTok Business: Most-used fields

The table below gives information about most-used fields that you can import from TikTok Business. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
audience_activity	audience_activity	Represents the overall activity or engagement of the audience for the business profile. This metric provides a general overview of audience interaction.	metric
audience_activity_hour	audience_activity_hour	Provides data on audience activity broken down by hour, indicating the times when the profile’s audience is most active.	dimension
audience_countries	audience_countries	A list or aggregated data representing the countries where the audience of the TikTok business profile is located. This information is available for both profile and video-specific analytics and reflects follower distribution over the past 60 days.	dimension
audience_country	audience_country	Represents a specific country where the audience of the TikTok business profile is located. This data is part of the country distribution of followers.	dimension
audience_country_percentage	audience_country_percentage	The percentage of the audience for the TikTok business profile residing in a specific country. This metric is derived from the country distribution of followers.	metric
audience_genders	audience_genders	The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base.	dimension
average_time_watched	average_time_watched	The average time, in seconds, users spent watching the video.	metric
business_id	business_id	The unique identifier for the TikTok business account.	dimension
caption	caption	The text caption of the video.	dimension
comments	comments	The total number of comments received on the video.	metric
create_time	create_time	The Unix timestamp (in seconds) indicating when the video was created and posted.	dimension
daily_lost_followers	daily_lost_followers		metric
daily_new_followers	daily_new_followers	The number of new followers gained by the TikTok Business profile on a specific day.	metric
daily_total_followers	daily_total_followers	The total number of followers a TikTok business profile has on a specific day. This metric corresponds to the ‘followers_count’ available through the API.	metric
date	date	The date for which the data is reported.	dimension
display_name	display_name	The public profile name of the TikTok account.	dimension
followers_count	followers_count	The total number of followers for the business profile.	metric
full_video_watched_rate	full_video_watched_rate	The percentage of viewers who watched the video from start to finish.	metric
impression_percentage	impression_percentage	The percentage of impressions for the content or profile.	metric
impressions_source	impressions_source	The source categories from which video impressions originated, providing insights into discovery channels.	dimension
is_business_account	is_business_account	Indicates whether the TikTok account is a business account.	dimension
item_id	item_id	The unique identifier for the video.	dimension
likes	likes	The total number of likes received on the video.	metric
profile_image	profile_image	The URL of the profile image associated with the TikTok Business profile.	dimension
profile_views	profile_views	The total number of times the business profile has been viewed.	metric
reach	reach	The number of unique users who have seen the video.	metric
share_url	share_url	The URL that can be used to share the TikTok video or profile.	dimension
shares	shares	The total number of times the video has been shared.	metric
thumbnail_url	thumbnail_url	The URL of the video’s thumbnail image.	dimension
total_time_watched	total_time_watched	The total accumulated time, in seconds, all users spent watching the video.	metric
username	username	The unique identifier or handle of the TikTok account.	dimension
video_duration	video_duration	The length of the video in seconds.	metric
video_views	video_views	The total number of times the video has been viewed (for video data) or total views across all profile videos (for profile data).	metric