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	Data representing the activity patterns of the business profile’s audience, such as peak engagement times.	metric
audience_activity_hour	audience_activity_hour	The hour of the day when the audience is most active.	dimension
audience_countries	audience_countries	Geographic distribution of the audience, either for a specific video or the overall business profile.	dimension
audience_country	audience_country	The country where the audience is located.	dimension
audience_country_percentage	audience_country_percentage	The percentage of the audience located in a specific country.	metric
audience_genders	audience_genders	Demographic breakdown of the business profile’s audience by gender.	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_new_followers	daily_new_followers	The number of new followers gained on a business profile within a specific day. This metric reflects the daily growth of the audience, derived from the daily changes in followers count.	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
engagement_rate	engagement_rate	A metric that quantifies the level of interaction a business profile or its content receives, typically calculated based on profile or video likes, comments, and shares relative to views or reach. This reflects overall video engagement.	metric
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
new_followers	new_followers	The total number of new followers gained on a business profile over a specified reporting period. This metric provides an overall indication of follower growth.	metric
profile_image	profile_image	The URL of the TikTok account’s profile image.	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