Social Metrics and Dimensions – Yext Help

These metrics and dimensions are available to users who have upgraded to Social. For accounts using basic posting features in Listings, see Social Metrics for Listings.

Note: Some data limitations impact Facebook and Instagram metrics. These are outlined in the Facebook API Docs and Instagram API Docs.

Yext scans Facebook and Instagram daily for updates to analytics. Posts created within 365 days of the current date are scanned daily. After 365 days, Yext no longer scans that post for updates.

Post Metrics

Post Likes / Reactions (Cumulative)

Description: The cumulative like count for the same post across LinkedIn, Facebook, and Instagram (total to date).

Request ID: POST_LIKES_REACTIONS_CUMULATIVE

Response ID: Post Likes / Reactions (Cumulative)

Data Type: Integer

Example Response Value: 20

Example Response: {"DAYS": "2024-03-01", "POST_LIKES_REACTIONS_CUMULATIVE": 20}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, POST_SOURCE, POST_TITLE, SOCIAL_POST_ID, SOCIAL_POST_LOCATION_ID, SOCIAL_POST_LOCATION_URL

Post Shares (Cumulative)

Description: The cumulative number of shares for the same post across LinkedIn, Facebook, and Instagram (total to date).

Request ID: POST_SHARES_CUMULATIVE

Response ID: Post Shares (Cumulative)

Data Type: Integer

Example Response Value: 20

Example Response: {"DAYS": "2024-03-01", "POST_SHARES_CUMULATIVE": 20}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, FB_POST_CLICK_TYPE, POST_SOURCE, POST_TITLE, SOCIAL_POST_ID, SOCIAL_POST_LOCATION_ID, SOCIAL_POST_LOCATION_URL

Total Post Reach (Cumulative)

Description: The cumulative reach for the same post across LinkedIn, Facebook, and Instagram (total to date).

Request ID: POST_REACH_CUMULATIVE

Response ID: Total Post Reach (Cumulative)

Data Type: Integer

Example Response Value: 20

Example Response: {"DAYS": "2024-03-01", "POST_REACH_CUMULATIVE": 20}

Facebook Post Click Rate

Description: The click rate of your Facebook post. Calculated as Total Post Clicks divided by Total Post Reach multiplied by 100.

Request ID: FB_POST_CLICK_RATE

Response ID: Facebook Post Click Rate

Data Type: Float (Percentage)

Example Response Value: 0.10

Example Response: {"DAYS": "2024-03-01", "Facebook Post Click Rate": 0.10}

Facebook Post Total Clicks

Description: The number of times people clicked anywhere in your post without generating a story.

Request ID: FB_POST_TOTAL_CLICKS

Response ID: Facebook Post Total Clicks

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_CLICKS": 150}

Facebook Post Total Reactions

Description: Total post reactions of all types, including like/care, love, wow, haha, sad, and anger. Includes reactions to all shared versions of your post.

Request ID: FB_POST_TOTAL_REACTIONS

Response ID: Facebook Post Total Reactions

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_REACTIONS": 100}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, FB_POST_REACTION_TYPE, POST_SOURCE, POST_TITLE, SOCIAL_POST_ID, SOCIAL_POST_LOCATION_ID, SOCIAL_POST_LOCATION_URL

Facebook Post Total Reach

Description: The number of people who had your Facebook page's post enter their screen. This metric is approximated by Facebook.

Request ID: FB_POST_TOTAL_REACH

Response ID: Facebook Post Total Reach

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_REACH": 100}

Facebook Post Paid Impressions

Description: The number of times your Facebook page's post entered a person's screen through paid distribution such as an ad.

Request ID: FB_POST_PAID_IMPRESSIONS

Response ID: Facebook Post Paid Impressions

Data Type: Integer

Example Response Value: 50

Example Response: {"DAYS": "2024-03-06","FB_POST_PAID_IMPRESSIONS": 50}

Facebook Post Paid Reach

Description: The number of people who had your Facebook page's post enter their screen through paid distribution such as an ad. This metric is approximated by Facebook.

Request ID: FB_POST_PAID_REACH

Response ID: Facebook Post Paid Reach

Data Type: Integer

Example Response Value: 25

Example Response: {"DAYS": "2024-03-06","FB_POST_PAID_REACH": 25}

Facebook Post Organic Impressions

Description: The number of times your Facebook page's post was on screen through organic distribution.

Request ID: FB_POST_ORGANIC_IMPRESSIONS

Response ID: Facebook Post Organic Impressions

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","FB_POST_ORGANIC_IMPRESSIONS": 150}

Facebook Post Organic Reach

Description: The number of people who had your Facebook page's post enter their screen through unpaid distribution. This metric is approximated by Facebook.

Request ID: FB_POST_ORGANIC_REACH

Response ID: Facebook Post Organic Reach

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","FB_POST_ORGANIC_REACH": 150}

Facebook Post Total Likes

Description: The total number of likes on your Facebook post. This number may be greater than or equal to the actual number of likes due to unlikes or deletion.

Request ID: FB_POST_TOTAL_LIKES

Response ID: Facebook Post Total Likes

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_LIKES": 100}

Facebook Post Total Comments

Description: The total number of comments on your Facebook post. This number may be greater than or equal to the actual number of comments due to comment privacy or deletion.

Request ID: FB_POST_TOTAL_COMMENTS

Response ID: Facebook Post Total Comments

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_COMMENTS": 100}

Facebook Post Total Shares

Description: The total number of shares on your Facebook post.

Request ID: FB_POST_TOTAL_SHARES

Response ID: Facebook Post Total Shares

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","FB_POST_TOTAL_SHARES": 100}

Instagram Post Engagement Rate

Description: The engagement rate of your Instagram post. Calculated as Total Interactions divided by Reach multiplied by 100.

Request ID: IG_POST_ENGAGEMENT_RATE

Response ID: Instagram Post Engagement Rate

Data Type: Percent

Example Response Value: 15%

Instagram Post Total Impressions

Description: The total number of times your Instagram post has been displayed to users.

Request ID: IG_POST_TOTAL_IMPRESSIONS

Response ID: Instagram Post Total Impressions

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","IG_POST_TOTAL_IMPRESSIONS": 100}

Instagram Post Reach

Description: The total number of unique Instagram accounts that have seen your post.

Request ID: IG_POST_REACH

Response ID: Instagram Post Reach

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","IG_POST_REACH": 150}

Instagram Post Total Interactions

Description: The total number of times your Instagram post has been interacted with. Includes likes, comments, saves, and shares.

Request ID: IG_POST_TOTAL_INTERACTIONS

Response ID: Instagram Post Total Interactions

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","IG_POST_TOTAL_INTERACTIONS": 150}

Instagram Post Total Saves

Description: The total number of unique Instagram accounts that have saved your post.

Request ID: IG_POST_TOTAL_SAVES

Response ID: Instagram Post Total Saves

Data Type: Integer

Example Response Value: 50

Example Response: {"DAYS": "2024-03-06","IG_POST_TOTAL_SAVES": 50}

Instagram Post Total Likes

Description: The total number of likes on your Instagram post minus the number of unlikes.

Request ID: IG_POST_TOTAL_LIKES

Response ID: Instagram Post Total Likes

Data Type: Integer

Example Response Value: 100

Instagram Post Total Comments

Description: The total number of comments on your Instagram post minus the number of deleted comments.

Request ID: IG_POST_TOTAL_COMMENTS

Response ID: Instagram Post Total Comments

Data Type: Integer

Example Response Value: 100

Instagram Post Total Shares

Description: The total number of shares on your Instagram post.

Request ID: IG_POST_TOTAL_SHARES

Response ID: Instagram Post Total Shares

Data Type: Integer

Example Response Value: 100

Total Comments Sent

Description: The total number of comments sent from the Social Comments and DMs inbox.

Request ID: TOTAL_COMMENTS_SENT_COUNT

Response ID: Total Comments Sent

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","TOTAL_COMMENTS_SENT_COUNT": 15}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, SITE, POST_TITLE, SOCIAL_POST_ID, SOCIAL_POST_LOCATION_ID, SOCIAL_POST_LOCATION_URL, SOCIAL_POST_AUTHOR_EMAIL

Total Comments Received

Description: The total number of comments received across platforms.

Request ID: TOTAL_COMMENTS_RECEIVED_COUNT

Response ID: Total Comments Received

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","TOTAL_COMMENTS_RECEIVED_COUNT": 15}

Total Direct Messages Sent

Description: The total number of direct messages sent from the Social Comments and DMs inbox.

Request ID: TOTAL_DMS_SENT_COUNT

Response ID: Total Direct Messages Sent

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","TOTAL_DMS_SENT_COUNT": 15}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, SOCIAL_POST_AUTHOR_EMAIL

Total Direct Messages Received

Description: The total number of direct messages received across platforms. Facebook and Instagram only.

Request ID: TOTAL_DMS_RECEIVED_COUNT

Response ID: Total Direct Messages Received

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","TOTAL_DMS_RECEIVED_COUNT": 15}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, SITE

Apple Showcase Taps

Description: Number of taps on Showcase on your Apple location's place card.

Request ID: APPLE_SHOWCASE_TAPS

Response ID: Apple Showcase Taps

Data Type: Integer

Example Response Value: 50

Example Response: {"DAYS": "2024-03-06","APPLE_SHOWCASE_TAPS": 50}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Total Post Impressions

Description: The total number of impressions for the same post across Facebook and Instagram.

Request ID: TOTAL_POST_IMPRESSIONS

Response ID: Total Post Impressions

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","TOTAL_POST_IMPRESSIONS": 150}

Total Post Reach

Description: The total reach for the same post across Facebook and Instagram.

Request ID: TOTAL_POST_REACH

Response ID: Total Post Reach

Data Type: Integer

Example Response Value: 150

Example Response: {"DAYS": "2024-03-06","TOTAL_POST_REACH": 150}

Post Count (Social Entity Posts)

Description: Count of individual social posts on your business's location pages. A social entity post is defined as one post shared to one page on one publisher.

Request ID: SOCIAL_POST_LOCATION_COUNT

Response ID: Post Count (Social Entity Posts)

Data Type: Integer

Example Response Value: 100

Example Response: {"DAYS": "2024-03-06","SOCIAL_POST_LOCATION_COUNT": 15}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS, POST_COUNT, POST_TITLE, SOCIAL_POST_AUTHOR_EMAIL, SOCIAL_POST_LOCATION_URL, SITES

Page Metrics

Facebook Page Posts Engagement Rate

Description: The engagement rate of your Facebook Page's posts. Calculated as total Page Post engagements divided by Page likes multiplied by 100.

Request ID: fb_page_posts_engagement_rate

Response ID: Facebook Page Posts Engagement Rate

Data Type: Float (Percentage)

Example Response Value: 0.45

Example Response: {"DAYS": "2024-03-06","fb_page_posts_engagement_rate": 0.45}

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Posts

Description: The total number of posts on a user's Instagram page.

Request ID: IG_PAGE_TOTAL_POSTS

Response ID: Instagram Page Total Posts

Data Type: Integer

Example Response Value: 150

Example Response: {"ENTITY_TYPE": "Location","IG_PAGE_TOTAL_POSTS": 150}

Limitation: Cannot be dimensioned by Time — filter must be set to All Time. Dimension by All Entities to get an accurate count of posts per profile.

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS

Instagram Page Total Followers

Description: The total number of Instagram users following the user.

Request ID: IG_PAGE_TOTAL_FOLLOWERS

Response ID: Instagram Page Total Followers

Data Type: Integer

Example Response Value: 150

Limitation: Cannot be dimensioned by Time — filter must be set to All Time. Dimension by All Entities to get an accurate count per profile.

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS

Instagram Page New Followers Per Day

Description: The total number of new followers each day within the specified range. Returns a maximum of 30 days of data. Not available on accounts with fewer than 100 followers.

Request ID: ig_page_new_followers_per_day

Response ID: Instagram Page New Followers Per Day

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Following Count

Description: The total number of Instagram users the user follows.

Request ID: ig_page_total_following

Response ID: Instagram Page Following Count

Data Type: Integer

Example Response Value: 150

Limitation: Cannot be dimensioned by Time — filter must be set to All Time. Dimension by All Entities to get an accurate count per profile.

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS

Instagram Page Engaged Accounts

Description: The number of accounts that have interacted with the user's content, including in ads. Includes likes, saves, comments, shares, and replies. This metric is estimated by Instagram.

Request ID: ig_page_total_accounts_engaged

Response ID: Instagram Page Engaged Accounts

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Impressions

Description: The total number of times the user's Instagram media has been viewed. Includes ad activity generated through the API, Facebook ads interface, and the Promote feature. Does not include profile views.

Request ID: ig_page_total_impressions

Response ID: Instagram Page Total Impressions

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Reach

Description: The total number of unique users who have viewed at least one of the user's Instagram media. Repeat views and views by the same user are only counted once.

Request ID: ig_page_total_reach

Response ID: Instagram Page Total Reach

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Interactions

Description: The total number of post interactions, story interactions, reels interactions, video interactions, and live video interactions, including any interactions on boosted content.

Request ID: ig_page_total_interactions

Response ID: Instagram Page Total Interactions

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Likes

Description: The number of likes on the user's posts, reels, and videos.

Request ID: ig_page_total_likes

Response ID: Instagram Page Total Likes

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Comments

Description: The number of comments on the user's posts, reels, videos, and live videos. This metric is estimated by Instagram.

Request ID: ig_page_total_comments

Response ID: Instagram Page Total Comments

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Saves

Description: The number of saves of the user's posts, reels, and videos.

Request ID: ig_page_total_saves

Response ID: Instagram Page Total Saves

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Total Shares

Description: The number of shares of the user's posts, stories, reels, videos, and live videos.

Request ID: ig_page_total_shares

Response ID: Instagram Page Total Shares

Data Type: Integer

Example Response Value: 150

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Instagram Page Engagement Rate

Description: The engagement rate of your Instagram page. Calculated as Total Interactions divided by Follower Count multiplied by 100.

Request ID: ig_page_engagement_rate

Response ID: Instagram Page Engagement Rate

Data Type: Float (Percentage)

Example Response Value: 0.80

Compatible Dimensions: ALL_ENTITIES, COUNTRY, ENTITY_TYPE, FOLDERS, LABELS, DAYS_OF_WEEK, DAYS, MONTHS, QUARTERS, WEEKS

Post Dimensions

Post Title

Description: The content of the Post Title field on the post create page, or the first 50 characters of your post content.

Request ID: POST_TITLE

Response ID: Post Title

Data Type: String

Example Response Value: New Product Post

Facebook Post Reaction Type

Description: Facebook Post Total Reactions broken down by type. Types include like/care, wow, haha, sad, and anger.

Request ID: FB_POST_REACTION_TYPE

Response ID: Facebook Post Reaction Type

Data Type: String

Example Response Value: Like / Care

Compatible Metrics: FB_POST_TOTAL_REACTIONS

Facebook Post Click Type

Description: Identifies Facebook clicks by their type. Options include link click, photo view, video view, or other.

Request ID: FB_POST_CLICK_TYPE

Response ID: Facebook Post Click Type

Data Type: String

Example Response Value: Photo View

Compatible Metrics: FB_POST_TOTAL_CLICKS

Social Post Location URL

Description: The URL associated with the social entity post. A social entity post is defined as one post shared to one page on one publisher.

Request ID: SOCIAL_POST_LOCATION_URL

Response ID: Social Post Location URL

Data Type: String

Example Response Value: https://www.facebook.com/00000000000000_0000000000\

Post Source

Description: Where the post was published from — either from the Yext UI or API (internal) or directly from the publisher (external).

Request ID: POST_SOURCE

Response ID: Post Source

Data Type: String

Example Response Value: Internal

Social Responder Email

Description: The user email of the person who replied to a comment or direct message.

Request ID: SOCIAL_RESPONDER_AUTHOR_EMAIL

Response ID: Social Responder Email

Data Type: String

Example Response Value: johndoe@gmail.com

Compatible Metrics: Total Direct Messages Sent, Total Comments Sent