Facebook Public Data: supported metrics & dimensions

Public pages statistics

Dimensions
Group Name Description
Account Account name Facebook Page name.
General info About Information about the Page. Can be read with Page Public Content Access or Page Public Metadata Access. This value maps to the Description setting in the Edit Page Info user interface. Limit of 100 characters.
General info Category The Page's category. e.g. Product/Service, Computers/Technology. Can be read with Page Public Content Access or Page Public Metadata Access.
General info Categories list The Page's sub-categories. This field will not return the parent category.
General info Company overview The company overview. Applicable to Companies. Can be read with Page Public Content Access or Page Public Metadata Access.
General info Cover image Id Information about the page's cover photo.
General info Cover image offset x Information about the page's cover photo.
General info Cover image offset y Information about the page's cover photo.
General info Cover image URL Information about the page's cover photo.
General info Page current location Current location of the Page. Can be read with Page Public Content Access or Page Public Metadata Access. To manage a child Page's location use the /{page-id}/locations endpoint.
General info Description Description of the post.
General info Description (HTML) Page description in HTML format.
General info Display subtest Subtext about the Page being viewed. Can be read with Page Public Content Access or Page Public Metadata Access.
General info Founded When the company was founded. Applicable to Pages in the Company category. Can be read with Page Public Content Access or Page Public Metadata Access.
General info General info General information provided by the Page. Can be read with Page Public Content Access or Page Public Metadata Access.
General info Link The Page's Facebook URL.
General info Username The alias of the Page. For example, for www.facebook.com/platform the username is 'platform'.
General info Website URL The URL of the Page's website. Can be read with Page Public Content Access or Page Public Metadata Access.
Contact info Contact address Id The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info City The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info City page The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Country The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Postal code The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Region The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Address 1 The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Address 2 The mailing or contact address for this page. This field will be blank if the contact address is the same as the physical address.
Contact info Delivery and pickup options A Vector of URL strings for delivery and pickup option info of the Page.
Contact info Differently open offerings To be used when temporary_status is set to differently_open to indicate how the business is operating differently than usual, such as a restaurant offering takeout. Enum keys can be one or more of the following: ONLINE_SERVICES, DELIVERY, PICKUP, OTHER with the value set to true or false. For example, a business offering food pick up but pausing delivery would be differently_open_offerings:{"DELIVERY":"false", "PICKUP":"true"}
Contact info Displayed message response time Page estimated message response time displayed to user. Can be read with Page Public Content Access or Page Public Metadata Access.
Contact info Emails The emails listed in the About section of a Page. Can be read with Page Public Content Access or Page Public Metadata Access.
Contact info Opening hours Indicates a single range of opening hours for a day. Each day can have 2 different hours ranges. The keys in the map are in the form of {day}{number}{status}. {day} should be the first 3 characters of the day of the week, {number} should be either 1 or 2 to allow for the two different hours ranges per day. {status} should be either open or close to delineate the start or end of a time range. An example with: { "hours": { "mon_1_open": "09:00", //open at 9am on Monday "mon_1_close": "12:00", //close at 12pm "mon_2_open": "13:15", //open at 1:15pm "mon_2_close": "18:00". //close at 6pm } If one specific day is open 24 hours, the range should be specified as 00:00 to 24:00. If the place is open 24/7, use the is_always_open field instead. Note: If a business is open during the night, the closing time can not pass 6:00am. For example, "mon_2_open":"13:15" and "mon_2_close":"5:59" will work however "mon_close_close":"6:00" will not.
Contact info Single line address The Page address, if any, in a simple single line format. Can be read with Page Public Content Access or Page Public Metadata Access.
Contact info WhatsApp number The Page's WhatsApp number. Can be read with Page Public Content Access or Page Public Metadata Access.
Featured video Id Video featured by the Page.
Featured video Category Video featured by the Page.
Featured video Tags Video featured by the Page.
Featured video Created at Video featured by the Page.
Featured video Custom labels Video featured by the Page.
Featured video Description Video featured by the Page.
Company Mission The company mission. Applicable to Companies.
Company Pharma safety info Pharmacy safety information. Applicable to Pharmaceutical companies. Can be read with Page Public Content Access or Page Public Metadata Access.
Company Products The products of this company. Applicable to Companies.
Legal Impressum Legal information about the Page publishers. Can be read with Page Public Content Access or Page Public Metadata Access.
Legal LeadGen Ads TOS acceptance time Indicates the time when the TOS for running LeadGen Ads on the page was accepted.
Legal LeadGen Ads TOS accepted Indicates whether a user has accepted the TOS for running LeadGen Ads on the Page.
Legal Accepting user Id Indicates the user who accepted the TOS for running LeadGen Ads on the page.
Legal Accepting user name Indicates the user who accepted the TOS for running LeadGen Ads on the page.
Legal Privacy info URL Privacy URL in page info section.
Messenger Ads Default icebreakers The default ice breakers for a certain page.
Messenger Ads Default quick replies The default quick replies for a certain page.
Messenger Ads Quick replies type Indicates what type this page is and we will generate different sets of quick replies based on it. Values include UNKNOWN, PAGE_SHOP, or RETAIL.
Band Artists we like Artists the band likes. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Band Band interests Band interests. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Band Band members Members of the band. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Band Bio Biography of the band. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access. Limit of 100 characters.
Band Booking agent Booking agent of the band. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Band Hometown Hometown of the band. Applicable to Bands.
Band Influences Influences on the band. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Band Press contact Press contact information of the band. Applicable to Bands.
Band Record label Record label of the band. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Awards The awards information of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Director of the film The director of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Genre The genre of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Plot outline The plot outline of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Produced by The producer of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Release date The film's release date. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Screenplay by The screenwriter of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Starring The cast of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access.
Film Studio The studio for the film production. Applicable to Films.
Place Checkin functionality Whether the Page has checkin functionality enabled. Can be read with Page Public Content Access or Page Public Metadata Access.
Place Checkins Number of checkins at a place represented by a Page.
Place Is always open Indicates whether this location is always open. Can be read with Page Public Content Access or Page Public Metadata Access.
Place Is chain Indicates whether location is part of a chain. Can be read with Page Public Content Access or Page Public Metadata Access.
Place City The location of this place. Applicable to all Places.
Place Country The location of this place. Applicable to all Places.
Place State The location of this place. Applicable to all Places.
Place Street The location of this place. Applicable to all Places.
Place Zip The location of this place. Applicable to all Places.
Place Parking lot Parking information. Applicable to Businesses and Places.
Additional info Brand global page name The name of the Page with country codes appended for Global Pages. Only visible to the Page admin. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Brand global root Id This brand's global Root ID.
Additional info Has transitioned to new page experience Indicates whether a page has transitioned to new page experience or not.
Additional info Has WhatsApp business number Indicates whether WhatsApp number connected to this page is a WhatsApp business number. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Has WhatsApp number Indicates whether WhatsApp number connected to this page is a WhatsApp number. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Is community page Indicates whether the Page is a community Page. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Is eligible for branded content Indicates whether the page is eligible for the branded content tool.
Additional info Is Messenger Platform Bot enabled Indicates whether the page is a Messenger Platform Bot with Get Started button enabled.
Additional info Is page a Messenger Platform Bot Indicates whether the page is a Messenger Platform Bot. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Is owned Indicates whether Page is owned. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Is permanently closed Whether the business corresponding to this Page is permanently closed. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Is published Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instantly published posts this value is always true)
Additional info Is unclaimed Indicates whether the Page is unclaimed.
Additional info Is webhooks subscribed Indicates whether the application is subscribed for real time updates from this page.
Additional info Members Members of this org. Applicable to Pages representing Team Orgs. Can be read with Page Public Content Access.
Additional info Name with location descriptor The name of the Page with its location and/or global brand descriptor. Only visible to a page admin. Non-page admins will get the same value as name.
Additional info Offer eligible Offer eligibility status. Only visible to a page admin.
Additional info Price range Price range of the business, such as a restaurant or salon. Values can be one of $, $$, $$$, $$$$, Not Applicable, or null if no value is set.. Can be read with Page Public Content Access or Page Public Metadata Access.
Additional info Promotion ineligible reason Reason for which boosted posts are not eligible. Only visible to a page admin.
Additional info Start info Information about when the entity represented by the Page was started.
Additional info Supports donate button in love videos Whether the user can add a Donate Button to their Live Videos.
Additional info Temporary status Indicates how the business corresponding to this Page is operating differently than usual. Possible values: differently_open, temporarily_closed, operating_as_usual, no_data. If set to differently_open use with differently_open_offerings to set status.
Additional info Unread messages count Unread message count for the Page. Only visible to a page admin.
Additional info Unread notifications count Number of unread notifications. Only visible to a page admin.
Additional info Unseen messages count Unseen message count for the Page. Only visible to a page admin.
Additional info Verification status Showing whether this Page is verified. Value can be blue_verified or gray_verified, which represents that Facebook has confirmed that a Page is the authentic presence of the public figure, celebrity, or global brand it represents, or not_verified. This field can be read with the Page Public Metadata Access feature.
Additional info Can post on page Indicates whether the current app user can post on this Page.
Additional info Merchant review status Review status of the Page against FB commerce policies, this status decides whether the Page can use component flow.
Place Parking street Parking information. Applicable to Businesses and Places.
Place Parking valet Parking information. Applicable to Businesses and Places.
Place Pickup options List of pickup options available at this Page's store location. Values can include CURBSIDE, IN_STORE, and OTHER.
Place Place type For places, the category of the place. Value can be CITY, COUNTRY, EVENT, GEO_ENTITY, PLACE, RESIDENCE, STATE_PROVINCE, or TEXT.
Place Store code Unique store code for this location Page. Can be read with Page Public Content Access or Page Public Metadata Access.
Place Store location description Location Page's store location descriptor.
Place Store number Unique store number for this location Page.
Restaurants / Nightlife Attire Dress code of the business. Applicable to Restaurants or Nightlife. Can be one of Casual, Dressy or Unspecified. Can be read with Page Public Content Access or Page Public Metadata Access.
Restaurants / Nightlife Culinary team Culinary team of the business. Applicable to Restaurants or Nightlife. Can be read with Page Public Content Access or Page Public Metadata Access.
Restaurants / Nightlife Food styles The restaurant's food styles. Applicable to Restaurants.
Restaurants / Nightlife General manager General manager of the business. Applicable to Restaurants or Nightlife. Can be read with Page Public Content Access or Page Public Metadata Access.
Restaurants / Nightlife Payment options - Amex Payment options accepted by the business. Applicable to Restaurants or Nightlife.
Restaurants / Nightlife Payment options - Cash only Payment options accepted by the business. Applicable to Restaurants or Nightlife.
Restaurants / Nightlife Payment options - Discover Payment options accepted by the business. Applicable to Restaurants or Nightlife.
Restaurants / Nightlife Payment options - Mastercard Payment options accepted by the business. Applicable to Restaurants or Nightlife.
Restaurants / Nightlife Payment options - Visa Payment options accepted by the business. Applicable to Restaurants or Nightlife.
Restaurants / Nightlife Public transit Public transit to the business. Applicable to Restaurants or Nightlife. Can be read with Page Public Content Access or Page Public Metadata Access.
Restaurants / Nightlife Restaurant services - Catering Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Delivery Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Groups Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Kids Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Outdoor Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Pickup Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Reserve Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Takeout Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Waiter Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant services - Walkins Services the restaurant provides. Applicable to Restaurants.
Restaurants / Nightlife Restaurant specialities - Breakfast The restaurant's specialties. Applicable to Restaurants.
Restaurants / Nightlife Restaurant specialities - Lunch The restaurant's specialties. Applicable to Restaurants.
Restaurants / Nightlife Restaurant specialities - Dinner The restaurant's specialties. Applicable to Restaurants.
Restaurants / Nightlife Restaurant specialities - Coffee The restaurant's specialties. Applicable to Restaurants.
Restaurants / Nightlife Restaurant specialities - Drinks The restaurant's specialties. Applicable to Restaurants.
TV show Network The TV network for the TV show. Applicable to TV Shows. Can be read with Page Public Content Access or Page Public Metadata Access.
TV show Shedule The air schedule of the TV show. Applicable to TV Shows. Can be read with Page Public Content Access or Page Public Metadata Access.
TV show Season The season information of the TV Show. Applicable to TV Shows. Can be read with Page Public Content Access or Page Public Metadata Access.
TV show Written by The writer of the TV show. Applicable to TV Shows. Can be read with Page Public Content Access or Page Public Metadata Access.
Vehicles Built Year vehicle was built. Applicable to Vehicles. Can be read with Page Public Content Access or Page Public Metadata Access.
Vehicles Features Features of the vehicle. Applicable to Vehicles. Can be read with Page Public Content Access or Page Public Metadata Access.
Vehicles MPG of the vehicle MPG of the vehicle. Applicable to Vehicles. Can be read with Page Public Content Access or Page Public Metadata Access.
VoIP info Has permission VoIP info.
VoIP info Has mobile app VoIP info.
VoIP info Is pushable VoIP info.
VoIP info Is callable VoIP info.
VoIP info Is callable WebRTC VoIP info.
VoIP info Reason code VoIP info.
VoIP info Reason description VoIP info.
Metrics
Group Name Description
Insights Lifetime followers Number of page followers.
Insights People directed from Global Page hierarchy If this is a Page in a Global Pages hierarchy, the number of people who are being directed to this Page. Can be read with Page Public Content Access or Page Public Metadata Access.
Insights Engagements count The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements count string The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements with like The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements without like The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements - Social sentence The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements - Social sentence with like The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Engagements - Social sentence without like The social sentence and like count information for this Page. This is the same info used for the like button.
Insights Page likes The number of users who like the Page. For Global Pages this is the count for all Pages across the brand. Can be read with Page Public Content Access or Page Public Metadata Access.
Insights New page likes The number of people who have liked the Page, since the last login. Only visible to a Page admin. Can be read with Page Public Content Access or Page Public Metadata Access.
Insights People talking about Page The number of people talking about this Page.
Insights Visits to Page's location The number of visits to this Page's location. If the Page setting Show map, check-ins and star ratings on the Page (under Page Settings > Page Info > Address) is disabled, then this value will also be disabled. Can be read with Page Public Content Access or Page Public Metadata Access.
Rating Overall star rating Overall page rating based on rating survey from users on a scale of 1-5. This value is normalized and is not guaranteed to be a strict average of user ratings. If there are 0 or a small number of ratings, this field will not be returned.
Rating Rating count Number of ratings for the Page (limited to ratings that are publicly accessible). Can be read with Page Public Content Access or Page Public Metadata Access.

Public posts statistics

Dimensions
Group Name Description
Account Id Account The ID of the user, page, group, or event that published the post.
Account name Account Facebook page name.
Message Post The message written in the post.
Attachment title Post Title of the attachment.
Attachment description Post Text accompanying the attachment.
Permalink Post The permanent static URL to the post on www.facebook.com. Example: https://www.facebook.com/FacebookforDevelopers/posts/10153449196353553.
Media URL Post Media object (photo, link etc.) contained in the attachment.
Media type Post Type of the media such as (photo, video, link etc).
Created at Post The time the post was published, expressed as UNIX timestamp.
Updated at Post The time the post was last updated, which occurs when a user comments on the post.
Media height Post Posted media height.
Media width Post Posted media width.
Status Post Description of the type of a status update.
Attachment type Post Type of the attachment. Possible types include: album, animated_image_autoplay, checkin, cover_photo, event, link, multiple, music, note, offer, photo, profile_media, status, video, video_autoplay, etc.
Attachment URL Post URL of the attachment.
Attachment unshimmed URL Post Unshimmed URL of the attachment.
Raw attachments data Post Raw attachments data.
Target URL Post Object that the attachment links to.
Attachment description tags Post Profiles tagged in the text accompanying the attachment.
Mentioned/targeted profiles Post Profiles mentioned or targeted in this post.
Video buying eligibility Post Whether the post can be promoted with different video buying options. It returns an empty list when video is eligible. Otherwise, it returns a list of reasons why the post cannot be promoted.
Timeline visibility Post Timeline visibility information of the post.
Promotable Id Post ID of post to use for promotion for stories that cannot be promoted directly.
Promotion status Post Status of the promotion, if the post was promoted.
Scheduled publish time Post UNIX timestamp of the scheduled publish time for the post.
Message tags Post Profiles tagged in message. This is an object with a unique key for each tag in the message.
Multi share end card Post Whether to display the end card for a multi-link share post.
Multi share optimized Post Whether to automatically select the order of the links in multi-link share post when used in an ad.
Call to action Post The call to action type used in any Page posts for mobile app engagement ads.
Event associated with Place Post If this Post has a place, the event associated with the place.
Instagram eligibility Post Whether the post can be promoted on Instagram. It returns the enum "eligible" if it can be promoted. Otherwise, it returns an enum for why it cannot be promoted.
Is user subscribed to post Post Whether user is subscribed to the post.
App post was published by Post Information about the app this post was published by.
Application Id Post
Application category Post
Application link Post
Application name Post
Application namespace Post
Is eligible for promotion Post Whether the post is eligible for promotion.
Is expired Post Whether the post has expiration time that has passed.
Is hidden Post Whether a post has been set to hidden.
Is Instagram eligible Post Whether this post can be promoted on Instagram.
Is popular Post Whether the post is currently popular. Based on whether the total actions as a percentage of reach exceeds a certain threshold.
Is published Post Indicates whether a scheduled post was published (applies to scheduled Page Post only, for users post and instantly published posts this value is always true).
Is spherical Post Whether the post is a spherical video post.
Metrics
Group Name Description
Engagement Likes The number of likes on your posts. Represents the approximate number as the actual number of results returned might be different depending on privacy settings.
Engagement Comments The number of comments on your posts. Represents the approximate number as the actual number of results returned might be different depending on privacy settings.
Engagement Shares The number of times your posts were shared.
Engagement Reactions The number of reactions on your posts.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Related Articles