Sprout Social: Most-used fields
The table below gives information about most-used fields that you can import from Sprout Social. 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.
activity_metadataDimension
This field contains metadata about the initial Sprout Social actions performed on a message, such as replies, tags, completions, and likes, including the actor and timestamp of these activities.
comments_countMetric
The total count of comments or replies on a profile or post.
comments_count_totalMetric
The overall total count of comments for a TikTok profile.
content_categoryDimension
A unified categorization of the content (e.g., album, video, photo, link, poll, or text).
created_dateDimension
The date and time when a post or other entity was created.
created_timeDimension
An ISO 8601 timestamp representing the publication date and time of the message or post.
customer_idDimension
The unique identifier for the Sprout Social customer account.
customer_profile.groupsDimension
An array of group IDs that the customer profile belongs to within Sprout Social.
customer_profile.linkDimension
A URL link to the customer's social media profile.
customer_profile.nameDimension
The human-facing name of the social network profile.
customer_profile.native_idMetric
The unique ID used by the native social network to identify the profile.
customer_profile.native_nameDimension
The user name, screen name, or page URL used by the native social network to identify a unique profile.
customer_profile.network_metadataDimension
Metadata specific to the social network of the customer profile.
customer_profile.network_typeDimension
The type of social network (e.g., X, Facebook, Instagram) for the customer profile.
customer_profile_idMetric
The unique ID used by Sprout Social to identify a social network profile.
engagementsMetric
The total number of interactions with content or a profile, such as likes, comments, shares, or clicks.
engagements_otherDimension
Engagements that are not categorized as likes, replies, reposts, or post link clicks.
followers_gainedMetric
The total number of new followers gained by the profile.
followers_gained_organicMetric
The number of new followers gained through organic (unpaid) reach.
followers_gained_paidMetric
The number of followers gained through paid promotions on a social media profile. This metric is available for Facebook and LinkedIn Owned Profile Metrics.
followers_lostMetric
The total number of followers who unfollowed the profile.
from.guidDimension
The native ID of the author's profile, prefixed with a Sprout code indicating the data source.
from.nameDimension
The display name of the message author.
from.profile_pictureDimension
The URL to the author's profile picture.
from.screen_nameDimension
The social media handle or screen name of the author, which is mutable on most networks.
groupsDimension
An array of IDs representing the groups a social network profile belongs to.
guidDimension
A globally unique identifier for the entity.
hashtagsDimension
A list of hashtags associated with the content.
impressionsMetric
The total number of times a post or profile content was displayed to users.
impressions_nonviralMetric
The number of times content from a social media profile was displayed to users through non-viral means, such as direct views or algorithmic reach. This metric is available for Facebook Owned Profile Metrics.
impressions_nonviral_uniqueDimension
The number of unique users who saw content from a social media profile through non-viral means. This metric is available for Facebook Owned Profile Metrics.
impressions_organicMetric
The total number of times organic content (unpaid) was displayed to users.
impressions_organic_uniqueDimension
The number of unique users who saw organic content (unpaid) at least once.
impressions_paidMetric
The number of times content from the profile was displayed through paid promotion.
impressions_paid_uniqueDimension
The number of unique users who saw content from the profile through paid promotion.
impressions_uniqueMetric
The number of unique users who saw content from the profile.
impressions_viralMetric
The number of times content from a social media profile was displayed to users through viral means, such as shares or mentions by friends. This metric is available for Facebook Owned Profile Metrics.
impressions_viral_uniqueDimension
The number of unique users who saw content from a social media profile through viral means. This metric is available for Facebook Owned Profile Metrics.
inbox_counts_sentDimension
The count of messages sent from the profile's inbox.
inbox_received_sentDimension
The count of pins received and sent within the Pinterest inbox. This metric is available for Pinterest Owned Profile Metrics.
instagram.post_impressions_organicMetric
The number of times an Instagram post was displayed organically.
lifetime.annotation_click_through_rateDimension
The rate at which viewers clicked on annotations displayed on YouTube videos over their lifetime. This metric is available for YouTube Post Metrics.
lifetime.annotation_clicksDimension
The total number of clicks on annotations displayed on YouTube videos over their lifetime. This metric is available for YouTube Post Metrics.
lifetime.annotation_impressionsDimension
The total number of times annotations were displayed on YouTube videos over their lifetime. This metric is available for YouTube Post Metrics.
lifetime.card_click_rateDimension
The rate at which cards in YouTube videos are clicked.
lifetime.card_clicksMetric
The total number of clicks on cards displayed within a YouTube video associated with a post.
lifetime.card_impressionsDimension
The total number of times YouTube cards were displayed on videos over their lifetime. This metric is available for YouTube Post Metrics.
lifetime.card_teaser_click_rateDimension
The rate at which card teasers in YouTube videos are clicked.
lifetime.comments_countMetric
The total count of comments or replies on a post over its lifetime.
lifetime.dislikesDimension
The total number of dislikes on a YouTube video.
lifetime.engagementsMetric
The total number of interactions with a post, including likes, comments, shares, and other actions, over its lifetime.
lifetime.engagements_follower_uniqueDimension
The total number of unique engagements generated by followers for a post over its lifetime.
lifetime.engagements_otherDimension
The total number of other engagements received on a post or profile that do not fall into other specific engagement categories.
lifetime.engagements_per_video_viewMetric
The ratio of total video engagements to the total number of video views.
lifetime.engagements_uniqueDimension
The total number of unique users who performed an interaction with a post over its lifetime, including actions such as likes, comments, shares, and other clicks.
lifetime.estimated_minutes_watchedDimension
The estimated total number of minutes users watched the YouTube video.
lifetime.impression_source_followDimension
The number of impressions originating from users who follow the profile on TikTok.
lifetime.impression_source_for_youDimension
The number of impressions originating from the 'For You' page on TikTok.
lifetime.impression_source_hashtagDimension
The total number of impressions a post received from users discovering it via hashtags over its lifetime. This metric is available for TikTok Post Metrics.
lifetime.impression_source_personal_profileDimension
The number of impressions originating from views on the personal profile page on TikTok.
lifetime.impression_source_soundDimension
The number of impressions originating from the sound page on TikTok.
lifetime.impression_source_unspecifiedDimension
The number of impressions originating from unspecified sources on TikTok.
lifetime.impressionsMetric
The total number of times a post was displayed to users over its lifetime.
lifetime.impressions_nonviral_uniqueDimension
The number of unique users who saw the content through non-viral distribution.
lifetime.impressions_organicMetric
The total number of organic (unpaid) impressions received over its lifetime.
lifetime.impressions_organic_uniqueMetric
The number of unique users who saw the content through organic distribution.
lifetime.impressions_paidDimension
The total number of paid impressions received over its lifetime.
lifetime.impressions_paid_uniqueDimension
The number of unique users who saw the content through paid distribution.
lifetime.impressions_uniqueMetric
The total number of unique users who saw the content (reach).
lifetime.impressions_viral_uniqueDimension
The number of unique users who saw the content through viral distribution.
lifetime.likesMetric
The total number of likes or positive reactions a post received over its lifetime.
lifetime.link_in_bio_clicksDimension
The total number of clicks on the link in bio on Instagram.
lifetime.net_sentiment_scoreMetric
The lifetime net sentiment score of a post, indicating the overall sentiment (positive, negative, or neutral) of associated comments or messages. This metric is available for Premium Analytics.
lifetime.post_content_clicksDimension
The total number of clicks on any content within the post.
lifetime.post_content_clicks_otherDimension
The total number of clicks on the post content that are not categorized as link, photo, or video play clicks.
lifetime.post_followers_gainedDimension
The number of new followers gained as a direct result of a specific post over its lifetime.
lifetime.post_followers_lostDimension
The number of followers lost as a direct result of a specific post over its lifetime.
lifetime.post_hashtag_clicksDimension
The total number of clicks on hashtags within a post over its lifetime.
lifetime.post_link_clicksDimension
The total number of clicks on links included in the post.
lifetime.post_media_clicksDimension
The total number of clicks on media (images, videos) within a post on X (formerly Twitter).
lifetime.post_media_viewsDimension
The total number of views of media (images, videos) associated with a post on X (formerly Twitter).
lifetime.post_other_clicks_uniqueDimension
The number of unique clicks on a post's content over its lifetime that are not categorized as link, photo, or video clicks.
lifetime.post_photo_view_clicksDimension
The total number of clicks on photos within the post to view them.
lifetime.post_video_play_clicksDimension
The total number of clicks to play videos embedded in the post.
lifetime.reactionsMetric
The total number of reactions (e.g., likes, loves, wows) a post received over its lifetime.
lifetime.reactions_angryDimension
The total number of angry reactions received on a Facebook post.
lifetime.reactions_hahaDimension
The total number of 'Haha' reactions received on a Facebook post.
lifetime.reactions_loveDimension
The total number of 'Love' reactions received on a Facebook post.
lifetime.reactions_sadDimension
The total number of 'Sad' reactions received on a Facebook post.
lifetime.reactions_wowDimension
The total number of 'Wow' reactions received on a Facebook post.
lifetime.reels_unique_session_playsDimension
The total number of unique play sessions for Reels content.
lifetime.savesMetric
The total number of times a post was saved by users over its lifetime.
lifetime.sentiment_comments_negative_countMetric
The lifetime count of comments on a post that have been classified as negative sentiment. This metric is available for Premium Analytics.
lifetime.sentiment_comments_neutral_countMetric
The lifetime count of comments on a post that have been classified as neutral sentiment. This metric is available for Premium Analytics.
lifetime.sentiment_comments_positive_countMetric
The lifetime count of comments on a post that have been classified as positive sentiment. This metric is available for Premium Analytics.
lifetime.shares_countMetric
The total number of times a post was shared or reposted by users over its lifetime.
lifetime.story_exitsDimension
The total number of times users exited an Instagram story.
lifetime.story_taps_backDimension
The total number of times users tapped back to the previous content in an Instagram story.
lifetime.story_taps_forwardDimension
The total number of times users tapped forward to the next content in an Instagram story.
lifetime.subscribers_gainedDimension
The total number of new subscribers gained from a YouTube video or channel.
lifetime.subscribers_lostDimension
The total number of subscribers lost from a YouTube video or channel.
lifetime.video_view_percentageDimension
The average percentage of a video that was watched over its lifetime.
lifetime.video_view_timeMetric
The total amount of time viewers spent watching videos over their lifetime.
lifetime.video_view_time_organicDimension
The total amount of time viewers spent watching organic videos over their lifetime.
lifetime.video_view_time_paidDimension
The total amount of time viewers spent watching paid videos over their lifetime.
lifetime.video_view_time_per_viewMetric
The average amount of time, in seconds, a user watched a video per view.
lifetime.video_viewsMetric
The total number of video views for a post over its lifetime.
lifetime.video_views_30s_completeDimension
The total number of times a video was watched for at least 30 seconds or to completion, whichever comes first.
lifetime.video_views_30s_complete_organicDimension
The total number of times a video was watched for at least 30 seconds or to completion through organic distribution.
lifetime.video_views_30s_complete_paidDimension
The total number of times a video was watched for at least 30 seconds or to completion through paid distribution.
lifetime.video_views_organicMetric
The total number of organic video views.
lifetime.video_views_organic_uniqueDimension
The total number of unique users who viewed the video through organic distribution.
lifetime.video_views_p100_per_viewDimension
The rate at which a video was watched to 100% completion per view.
lifetime.video_views_paidDimension
The total number of paid video views.
lifetime.video_views_paid_uniqueDimension
The total number of unique users who viewed the video through paid distribution.
lifetime.video_views_partialDimension
The total number of times a video was partially viewed (less than 30 seconds or completion).
lifetime.video_views_partial_organicDimension
The total number of times a video was partially viewed through organic distribution.
lifetime.video_views_partial_paidDimension
The total number of times a video was partially viewed through paid distribution.
lifetime.video_views_uniqueDimension
The total number of unique users who viewed the video.
lifetime.videos_added_to_playlistDimension
The total number of times the YouTube video was added to a playlist.
lifetime.videos_removed_from_playlistDimension
The total number of times the YouTube video was removed from a playlist.
lifetime.vote_countDimension
The total number of votes received on a poll.
lifetime_snapshot.followers_by_age_genderDimension
A lifetime snapshot of the audience breakdown by age and gender demographics.
lifetime_snapshot.followers_by_countryDimension
A lifetime snapshot of the audience breakdown by country.
lifetime_snapshot.followers_by_genderDimension
A lifetime snapshot of the audience breakdown by gender.
lifetime_snapshot.followers_countMetric
The total number of followers for the profile as a lifetime snapshot.
lifetime_snapshot.followers_onlineDimension
The number of followers who are currently online for a TikTok profile at the time the snapshot was taken. This metric is available for TikTok Owned Profile Metrics.
lifetime_snapshot.following_countMetric
The total number of profiles a social media account is following. This metric is available for Instagram and Pinterest Owned Profile Metrics.
likesMetric
The total number of likes received on a social media post or associated with a topic. This metric is available across various social networks for both owned profiles and individual posts, as well as for messages within Listening Topics.
likes_totalMetric
The total number of likes received on posts or profile content.
location.cityDimension
An estimation of the city where the message was posted. This data is primarily available for X (formerly Twitter) and can be inferred from other networks based on the author's bio or message content.
location.countryDimension
An estimation of the country where the message was posted. This data is primarily available for X (formerly Twitter) and can be inferred from other networks based on the author's bio or message content.
location.provinceDimension
An estimation of the province where the message was posted. This data is primarily available for X (formerly Twitter) and can be inferred from other networks based on the author's bio or message content.
mentionsMetric
A list of other profiles mentioned within the message content.
nameDimension
The human-facing name of the social network profile or the display name of the author of a message. It can also represent the name of a customer, group, user, or topic within Sprout Social.
native_idDimension
The unique identifier of a social network profile as assigned by the native social network (e.g., Twitter, Instagram). This ID is used by the social network to identify a profile.
native_nameDimension
The user name, screen name, or page URL that the native social network uses to identify a unique profile.
negative_sentiments_countDimension
The count of messages or comments expressing a negative sentiment.
net_follower_growthMetric
The overall change in the number of followers for a social profile over a specific period, calculated as followers gained minus followers lost.
net_following_growthMetric
The net increase or decrease in the number of followers (followers gained minus followers lost).
networkDimension
The social network platform from which the data originated (e.g., INSTAGRAM, FACEBOOK).
network_typeDimension
The type of social network (e.g., X, Facebook, Instagram) associated with a profile or message.
neutral_sentiments_countDimension
The count of messages or comments expressing a neutral sentiment.
perma_linkDimension
The permanent URL that links directly to the specific social media message or post on its native social network.
pin_countDimension
The total number of pins associated with a Pinterest profile. This metric is available for Pinterest Owned Profile Metrics.
positive_sentiments_countDimension
The count of messages or comments expressing a positive sentiment.
post_app_engagementsDimension
The number of engagements with an app promoted through a post. This metric is available for X Owned Profile Metrics.
post_app_installsDimension
The number of app install attempts initiated from a post. This metric is available for X Owned Profile Metrics.
post_app_opensDimension
The number of app opens originating from a post. This metric is available for X Owned Profile Metrics.
post_categoryDimension
A categorical classification of the post content.
post_content_clicksMetric
The total number of clicks on the content of a post.
post_content_clicks_otherMetric
The number of clicks on a post's content that are not categorized as link, photo, or video clicks. This metric is available for X and Facebook Owned Profile Metrics, and YouTube Calculated Post Metrics.
post_detail_expand_clicksDimension
The number of times users clicked to expand the details of a post. This metric is available for X Owned Profile Metrics and X Post Metrics.
post_engagementsMetric
The total number of engagements on a post (e.g., likes, comments, shares, clicks).
post_hashtag_clicksDimension
The number of clicks on hashtags within a post.
post_impressionsMetric
The total number of times a post was displayed to users.
post_impressions_nonviralDimension
The number of times a post was displayed to users through non-viral means. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
post_impressions_organicMetric
The total number of times organic posts were displayed to users.
post_impressions_paidDimension
The number of times a post was displayed through paid promotion.
post_impressions_viralDimension
The number of times a post was displayed to users through viral means (e.g., shares by friends). This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
post_link_clicksMetric
The total number of clicks on links within a post.
post_media_clicksDimension
The total number of clicks on media (images, videos) within a post.
post_media_viewsDimension
The total number of views for media (images, videos) within a post.
post_profile_clicksDimension
The total number of clicks on the profile name or picture originating from a post.
post_typeDimension
Uniquely identifies the social network and type of message or post (e.g., TWEET, FACEBOOK_POST, INSTAGRAM_MEDIA).
posts_sent_by_content_typeDimension
The count of posts sent, broken down by their content type (e.g., photo, video, text). This metric is available for X, Facebook, Instagram, and LinkedIn Owned Profile Metrics.
posts_sent_by_post_typeDimension
The count of posts sent, broken down by their specific post type (e.g., Tweet, Facebook Post, Instagram Media). This metric is available for X, Facebook, Instagram, LinkedIn, and TikTok Owned Profile Metrics.
posts_sent_countMetric
The total number of posts sent from the profile.
profile_guidDimension
The unique ID of the tracked profile, prefixed with a Sprout code. If the message was from the tracked profile, this is identical to from.guid.
profile_viewsMetric
The total number of times a social media profile was viewed.
profile_views_totalDimension
The total number of times a social media profile was viewed.
question_answersDimension
The total number of answers received for questions posted on social media. This metric is available for Facebook Post Metrics.
reactionsMetric
The total number of reactions (e.g., likes, loves, wows) received on a profile or post.
reactions_angryMetric
The total number of "angry" reactions received on content.
reactions_hahaMetric
The total number of "haha" reactions received on content.
reactions_loveMetric
The total number of "love" reactions received on content.
reactions_sadMetric
The total number of "sad" reactions received on content.
reactions_wowMetric
The total number of "wow" reactions received on content.
repliesMetric
The number of replies to messages or comments.
reporting_period.by(day)Dimension
A dimension used to break down analytics data by day.
savesMetric
The total number of times a post or content was saved by users on a profile.
sentDimension
A boolean value indicating if the message was sent by the requested profiles (true) or received by them (false).
sent_byDimension
Information about the team member who sent a message or post via Sprout Social, including their ID, email address, first name, and last name.
sentimentDimension
The overall sentiment expressed in messages or comments (e.g., positive, negative, neutral).
shares_countMetric
The total number of times a message or post was shared.
shares_count_totalMetric
The total number of times content was shared by users.
story_repliesMetric
The total number of replies received on stories. This metric is available for Instagram Owned Profile Metrics and Instagram Post Metrics (as lifetime.comments_count for story replies).
tag.activeDimension
Indicates if a tag is currently active.
tag.any_groupDimension
Indicates whether a message tag is available in any customer group. This field is part of the Customer Tags Endpoint response.
tag.groupsDimension
An array of IDs of the groups that a specific tag is available in. This field is part of the Customer Tags Endpoint response.
tag.textDimension
The textual content of the tag.
tag.typeDimension
The type of the tag, such as LABEL or CAMPAIGN. This field is part of the Customer Tags Endpoint response.
tag_idDimension
A unique identifier for the tag.
textDimension
The textual content of the message or post.
titleDimension
The title of the post or content.
topic_idDimension
A unique identifier for a listening topic.
video_lengthDimension
The duration or length of the video content.
video_view_timeMetric
The total duration (in seconds) that videos were watched on a profile or for a specific post.
video_viewsMetric
The total number of views for a video on a profile or individual post.
video_views_30s_completeMetric
The number of times a video was viewed for at least 30 seconds or to completion.
video_views_30s_complete_autoplayMetric
The number of times a video was viewed for at least 30 seconds or to completion due to autoplay.
video_views_30s_complete_click_to_playMetric
The number of times a video was viewed for at least 30 seconds or to completion due to a user clicking to play.
video_views_30s_complete_organicMetric
The number of times a video was viewed for at least 30 seconds or to completion through organic reach.
video_views_30s_complete_paidMetric
The number of times a video was viewed for at least 30 seconds or to completion through paid promotion.
video_views_30s_complete_repeatMetric
The number of times a video was viewed for at least 30 seconds and was replayed. This metric is available for Facebook Owned Profile Metrics.
video_views_30s_complete_uniqueMetric
The number of unique users who viewed a video for at least 30 seconds or to completion.
video_views_autoplayMetric
The number of times a video started playing automatically. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_click_to_playMetric
The number of times a video started playing due to a user click. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_organicMetric
The number of times a video has been viewed through unpaid or natural distribution channels. This metric excludes views obtained through paid promotion. Primarily available for Facebook video content.
video_views_paidMetric
The total number of video views acquired through paid promotion.
video_views_partialMetric
The number of times a video was partially viewed. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_partial_autoplayMetric
The number of times a video was partially viewed after starting via autoplay. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_partial_click_to_playMetric
The number of times a video was partially viewed after starting via a user click. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_partial_organicMetric
The number of times a video was partially viewed through organic reach. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_partial_paidMetric
The number of times a video was partially viewed through paid promotions. This metric is available for Facebook Owned Profile Metrics and Facebook Post Metrics.
video_views_partial_repeatMetric
The number of times a video was partially viewed during a repeat play. This metric is available for Facebook Owned Profile Metrics.
video_views_repeatMetric
The number of times a video was replayed. This metric is available for Facebook Owned Profile Metrics.
video_views_totalMetric
The total number of video views.
video_views_uniqueDimension
The total number of unique users who watched videos.
visual_mediaDimension
An array of media shared on the message, such as photos and videos, often including URLs for the full media, high-resolution display images, and thumbnail images. This field is available in Message Metadata and Listening Message Fields.