We'd love to hear from you...
Your feedback helps us make the Meltwater API suite better. If you'd be happy to have a quick call with our product team please let us know... Book a Call
Owned Social Metrics
The table below summarizes the metrics available for owned social analytics features. Learn more about owned social analytics features by reading our quickstart guide.
Please note that:
- For X use
twitter
as the source name in API requests.
Account metrics
Name | Metric | Type | Description |
---|---|---|---|
Page fans | page_fans |
int | The total number of people who have liked your page. |
Page fan adds | page_fan_adds |
int | The number of new people who have liked your page. |
Page fan removes | page_fan_removes |
int | The number of people who have unliked your page. |
Page post engagements | page_post_engagements |
int | The number of times people have engaged with your posts through reactions, comments, shares, etc. |
Page impressions | page_impressions |
int | The number of times any content from your page (or about your page) entered a person's screen. |
Page organic impressions (unique users) | page_impressions_organic_unique |
int | The number of people who had any content from your Page or about your Page enter their screen through unpaid distribution. This includes posts, stories, check-ins, social information from people who interact with your Page and more. |
Page organic impressions | page_impressions_organic |
int | The number of times any post or story content from your page (or about your page) entered a person's screen through unpaid distribution. |
Page impressions (unique users) | page_impressions_unique |
int | The number of people who had any content from your Page or about your Page enter their screen. This includes posts, check-ins, ads, social information from people who interact with your Page and more. |
Page impressions viral | page_impressions_viral |
int | The number of times any content from your Page or about your Page entered a person's screen with social information attached. Social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. |
Page impressions viral (unique users) | page_impressions_viral_unique |
int | The number of people who had any content from your Page or about your Page enter their screen through with social information attached. As a form of organic distribution, social information displays when a person's friend interacted with your Page, post or story. This includes when someone's friend likes or follows your Page, engages with a post, shares a photo of your Page and checks into your Page. |
Page video views | page_video_views |
int | The number of times your page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. |
Page video view time | page_video_view_time |
int | The total time, in milliseconds, people viewed your page's video. |
Page fans gender and age | demographics_gender_age |
nested-breakdown | An estimated breakdown by gender and age of the people who have liked your page. |
Page fans countries | demographics_audience_country |
breakdown | A breakdown by country of the people who have liked your page. |
Page fans cities | demographics_audience_city |
breakdown | A breakdown by city of the people who have liked your page. |
Post metrics
Name | Metric | Type | Description |
---|---|---|---|
Post reactions | reactions_count |
int | Total reactions for the post. |
Post clicks links | post_clicks_link |
int | Total number of clicks on links in the post. |
Post clicks other | post_clicks_other |
int | Total number of clicks on other content in the post. |
Post clicks photo | post_clicks_photo |
int | Total number of clicks on photos in the post. |
Post clicks video | post_clicks_video |
int | Total number of clicks on videos in the post. |
Post like reactions | post_reactions_like_total |
int | Total "like" reactions for the post |
Post love reactions | post_reactions_love_total |
int | Total "love" reactions for the post. |
Post wow reactions | post_reactions_wow_total |
int | Total "wow" reactions for the post. |
Post haha reactions | post_reactions_haha_total |
int | Total "haha" reactions for the post. |
Post sorry reactions | post_reactions_sorry_total |
int | Total "sorry" reactions for the post. |
Post anger reactions | post_reactions_anger_total |
int | Total "anger" reactions for the post. |
Post comments | comments_count |
int | Total number of comments for the post. |
Post shares | shares_count |
int | Total number of shares for the post. |
Post engagement | engagements |
float | Shares + comments + reactions + click counts. |
Post engagement rate | engagement_rate |
float | The number of users who engaged with the post divided by the number that saw the post. |
Post impressions | post_impressions |
int | The number of times the post entered a person's screen. |
Post organic impressions | post_impressions_organic |
int | The number of times the post entered a person's screen throught un paid distribution. |
Post engagement rate from page fans | page_fans_engagement_rate |
float | The number of page fans who engaged with the post divided by the number that saw the post. |
Post clicks | post_clicks |
int | The number of times people clicked anywhere in the post without generating a story. |
Post clicks (unique users) | post_clicks_unique |
int | The number of people who clicked anywhere in the post without generating a story. |
Post engaged users | post_engaged_users |
int | The number of people who clicked anywhere in the post. |
Post organic impressions (unique users) | post_impressions_organic_unique |
int | The number of people who had the post enter their screen through unpaid distribution. |
Post impressions (unique users) | post_impressions_unique |
int | The number of people who had the post enter their screen. |
Post video average time watched | post_video_avg_time_watched |
int | The average time (in milliseconds) for which people viewed the post's video. |
Post video total view time | post_video_view_time |
int | The total time (in milliseconds) the post's video has been played for, including videos played for less than 3 seconds and replays. Returns 0 for reshared videos. |
Post video views | post_video_views |
int | The number of times the post's video has been played for at least 3 seconds (or for nearly their total length if they're shorter than 3 seconds). |
Post organic video views | post_video_views_organic |
int | The number of times the post's video, through unpaid distribution, has been played for at least 3 seconds (or for nearly their total length if they're shorter than 3 seconds). |
Account metrics
Name | Metric | Type | Description |
---|---|---|---|
Email contacts | email_contacts |
int | Total number of taps on the email link in the IG User's profile. |
Followers | total_followers_count |
int | Total number of followers. |
New followers | follower_count |
int | Number of new followers each day within the specified range. |
Get directions clicks | get_directions_clicks |
int | Total number of taps on the directions link in the IG User's profile. |
Phone call clicks | phone_call_clicks |
int | Total number of taps on the call link in the IG User's profile. |
Text message clicks | text_message_clicks |
int | Total number of taps on the text message link in the IG User's profile. |
Website clicks | website_clicks |
int | Total number of clicks on the website link in the Instagram user's profile. |
Profile views | profile_views |
int | Total number of users who have viewed the Instagram user's profile. |
Total impressions | impressions |
int | Total number of times the Instagram user's media have been viewed. |
Followers gender and age | demographics_gender_age |
nested-breakdown | An estimated breakdown by gender and age of followers of the account. |
Followers countries | demographics_audience_country |
breakdown | A breakdown by country of the followers of the account. |
Followers cities | demographics_audience_city |
breakdown | A breakdown by city of the followers of the account. |
Post metrics
Name | Metric | Type | Description |
---|---|---|---|
Post comments | comments_count |
int | Total number of comments for the post. |
Post engagement | engagement |
int | Sum of likes, comment, shares, and saved counts on the IG Media. |
Post engagement rate | engagement_rate |
float | The number of users who engaged with the post divided by the number that saw the post. |
Post exits | exits |
int | Total number of times someone exited the story IG Media object. |
Post impressions | impressions |
int | Total number of times the post has been seen. |
Post likes | like_count |
int | Total "like" reactions for the post. |
Post plays | plays |
int | Number of times the reels starts to play after an impression is already counted. This is defined as video sessions with 1 ms or more of playback and excludes replays. |
Post reach | reach |
int | Total number of unique Instagram accounts that have seen the post. |
Post replies | replies |
int | Total number of replies. |
Post saves | saved |
int | Total number of unique Instagram accounts that have saved the post. |
Post shares | shares |
int | Total number of shares. |
Post taps back | taps_back |
int | Total number of taps to see this story IG Media object's previous photo or video. |
Post taps forward | taps_forward |
int | Total number of taps to see this story IG Media object's next photo or video. |
Post total Interactions | total_interactions |
int | Number of likes, saves, comments, and shares on the reel, minus the number of unlikes, unsaves, and deleted comments. |
Post followers count engagement rate | followers_count_engagement_rate |
float | The percentage of followers that engaged with the post. |
Post video views | video_views |
int | Total number of times the post's video has been seen. |
Account metrics
Name | Metric | Type | Description |
---|---|---|---|
Followers | followers |
int | Total number of followers |
Organic follower gain | organic_follower_gain |
int | Total number of organic followers gained |
Paid follower gain | paid_follower_gain |
int | Total number of paid followers gained |
Desktop page views | all_desktop_page_views |
int | Total number of desktop page views |
Mobile page views | all_mobile_page_views |
int | Total number of mobile page views |
Page views | all_page_views |
int | Total number of page views |
Post metrics
Name | Metric | Type | Description |
---|---|---|---|
Post click count | click_count |
int | Total number of clicks for the post. |
Post comment count | comment_count |
int | Total number of comments for the post. |
Post engagement | engagements |
float | Total engagement for the post. |
Post engagement | engagement_rate |
float | The number of users who engaged with the post divided by the number that saw the post. |
Post impression count | impression_count |
int | Total number of impressions for the post. |
Post like count | like_count |
int | Total number of likes for the post. |
Post share count | share_count |
int | Total number of shares for the post. |
Post video views | video_view |
int | Total number of video views for the post. |
Tiktok
Account metrics
Name | Metric | Type | Description |
---|---|---|---|
Fans | fans |
int | Total number of fans for the account. |
Net new fans | net_new_fans |
int | Net net fans for the account. |
Profile views | profile_views |
int | Total number of profile views for the account. |
Video views | video_views |
int | Total number of video views for the account. |
Post metrics
Name | Metric | Type | Description |
---|---|---|---|
Post average watch time | average_watch_time |
float | The average watch time for the video. |
Post comments | comments |
int | The total number of comments the video has received. |
Post engagement Rate | engagement_rate |
float | Total engagement rate for the video. |
Post engagement | engagements |
float | Total engagement for the video. |
Post full video watched rate | full_video_watch_rate |
float | Percentage of viewers who viewed the whole video. |
Post likes | likes |
int | The total number of likes the video has received. |
Post reach | reach |
int | Total number of unique viewers who viewed the video. |
Post shares | shares |
int | The total number of times the video has been shared. |
Post video views | video_views |
int | The total number of views the video has received. |
X
Account metrics
Name | Metric | Type | Description |
---|---|---|---|
Followers | followers_count |
int | Total number of followers. |
Post metrics
Name | Metric | Type | Description |
---|---|---|---|
Post app install attempts | app_install_attempts |
int | A count of how many times an App Install event has occurred from the post |
Post app opens | app_opens |
int | A count of how many times an App Open event has occurred from the post. |
Post detail expands | detail_expands |
int | A count of how many times the post has been clicked to see more details. |
Post email tweet | email_tweet |
int | A count of how many times the post has been shared via email. |
Post engagement rate | engagement_rate |
float | Engagement rate for the post. |
Post engagements | engagements |
int | A count of the number of times a user has interacted with the post. |
Post favorites | favorites |
int | A count of how many times the post has been favorited. |
Post hashtag clicks | hashtag_clicks |
int | A count of how many times a hashtag in the post has been clicked. |
Post impressions | impressions |
int | A count of how many times the post has been viewed. |
Post media clicks | media_clicks |
int | A count of how many times media such as an image or video in the post has been clicked. |
Post media engagements | media_engagements |
int | A count of how many times media such as an image or video in the post has been clicked. |
Post media views | media_views |
int | A count of all views (autoplay and click) of your media counted across videos, gifs, and images. |
Post permalink clicks | permalink_clicks |
int | A count of how many times the permalink to the post (the individual web page dedicated to this post) has been clicked. |
Post quote posts | quote_tweets |
int | A count of times a post has been reposted with a comment (also known as Quote). |
Post replies | replies |
int | A count of how many times the post has been replied to. |
Post reposts | retweets |
int | A count of how many times the post has been reposted. |
Post unfavorites | unfavorites |
int | A count of how many times a favorite on the post was removed. |
Post unquote posts | unquote_tweets |
int | A count of how many times a quote of the post was removed. |
Post unreplies | unreplies |
int | A count of how many times a reply to the post was removed. |
Post un-reposts | unretweets |
int | A count of how many times a repost of the post was removed. |
Post url clicks | url_clicks |
int | A count of how many times a URL in the post has been clicked. |
Post user follows | user_follows |
int | A count of how many times the User (post author) has been followed from this post. |
Post user profile clicks | user_profile_clicks |
int | A count of how many times the User (post author) has had their profile clicked from this post. |
Post user unfollows | user_unfollows |
int | A count of how many times the User (post author) has been unfollowed. |
Post video starts | video_starts |
int | A count of how many times a video in the post started. |
Post video views | video_views |
int | A count of how many times a video in the given post has been 50% visible for at least two seconds. |
Post video viewed 100 | video_viewed_100 |
int | A count of how many times 100% of a video in the post was watched. |
Post video viewed 25 | video_viewed_25 |
int | A count of how many times 25% of a video in the post was watched. |
Post video viewed 50 | video_viewed_50 |
int | A count of how many times 50% of a video in the post was watched. |
Post video viewed 75 | video_viewed_75 |
int | A count of how many times 75% of a video in the post was watched. |
Post video viewed 95 | video_viewed_95 |
int | A count of how many times 95% of a video in the post was watched. |