Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
audience_activityMetric

Represents the overall activity or engagement of the audience for the business profile. This metric provides a general overview of audience interaction.

audience_activity_hourDimension

Provides data on audience activity broken down by hour, indicating the times when the profile's audience is most active.

audience_countriesDimension

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.

audience_countryDimension

Represents a specific country where the audience of the TikTok business profile is located. This data is part of the country distribution of followers.

audience_country_percentageDimension

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.

audience_gendersDimension

The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base.

average_time_watchedMetric

The average time, in seconds, users spent watching the video.

business_idDimension

The unique identifier for the TikTok business account.

captionDimension

The text caption of the video.

commentsMetric

The total number of comments received on the video.

create_timeDimension

The Unix timestamp (in seconds) indicating when the video was created and posted.

daily_new_followersMetric

The number of new followers gained by the TikTok Business profile on a specific day.

daily_total_followersMetric

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.

dateDimension

The date for which the data is reported.

display_nameDimension

The public profile name of the TikTok account.

followers_countMetric

The total number of followers for the business profile.

full_video_watched_rateMetric

The percentage of viewers who watched the video from start to finish.

genderDimension

The gender distribution of the audience following the TikTok business profile. This metric provides insights into the demographic makeup of the follower base.

gender_percentageDimension

The percentage of the audience for the TikTok business profile belonging to a specific gender. This metric is derived from the audience's gender distribution.

hourMetric

Represents the hour of the day when collecting data, used to analyze audience activity and engagement patterns on an hourly basis.

impression_percentageMetric

The percentage of impressions for the content or profile.

impressions_sourceDimension

The source categories from which video impressions originated, providing insights into discovery channels.

is_business_accountDimension

Indicates whether the TikTok account is a business account.

item_idDimension

The unique identifier for the video.

likesMetric

The total number of likes received on the video.

profile_imageDimension

The URL of the profile image associated with the TikTok Business profile.

profile_viewsMetric

The total number of times the business profile has been viewed.

reachMetric

The number of unique users who have seen the video.

share_urlDimension

The URL that can be used to share the TikTok video or profile.

sharesMetric

The total number of times the video has been shared.

thumbnail_urlDimension

The URL of the video's thumbnail image.

total_time_watchedMetric

The total accumulated time, in seconds, all users spent watching the video.

usernameDimension

The unique identifier or handle of the TikTok account.

video_durationDimension

The length of the video in seconds.

video_viewsMetric

The total number of times the video has been viewed (for video data) or total views across all profile videos (for profile data).