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_country	audience_country	Represents the country of origin for your audience. In profile reports, this refers to the top 10 countries where your total followers originate from. In video reports, it indicates the top 10 countries of origin for viewers of a specific video on a given day. Countries outside the top 10 are categorized as “Other.”	dimension
audience_country_percentage	audience_country_percentage	The percentage of the audience for the TikTok business profile or individual videos that originates from a specific country.	metric
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
date	date	The date for which the data is reported.	dimension
display_name	display_name	The public profile name of the TikTok account.	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.	metric
item_id	item_id	The unique identifier for the video.	dimension
likes	likes	The total number of likes received on the video.	metric
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