Page - Graph API Reference - Documentation - Meta for Developers
Graph API Overview Get Started Batch Requests Debug Requests Handle Errors Field Expansion Secure Requests Changelog Reference Graph API Version v27.0 Page Represents a Facebook Page . Over the coming months, all classic Pages will be migrated to the New Pages Experience. Use the has_transitioned_to_new_page_experience Page field to determine if a Page has been migrated. After all Pages have been migrated, the classic Pages experience will no longer be available.
Refer to our Pages API Guides for additional usage information. Reading Get information about a Facebook Page. Requirements For apps that have been granted the pages_read_engagement and pages_read_user_content permissions, only data owned by the Page is accessible. For apps that have been approved for either the Page Public Content Access (PPCA) or Page Public Metadata Access (PPMA) feature, only public data is accessible.
Learn more. The instagram_business_account field requires a User access token from a User who is able to perform appropriate tasks on the Page. Refer to the Instagram Graph API's Page reference for more information. If using a business system user in your request, the business_management permission may be required. Limitations A Page access token is required for any fields that may include User information. All users requesting access to a Page using permissions must be able to perform the MODERATE task on the Page being queried.
When using the Page Public Content Access feature, use a system user access token to avoid rate limiting issues. If the page url is being used as the query input, ensure the page url is set up the following way: facebook.com/<pageusername>. More information on the page username. Public Page Data Requirements vary based on the Page's status, unpublished or published, and unrestricted or restricted. Restrictions include any visibility restrictions such as by age or region.
Note that for restricted Pages, the app user must also satisfy any restrictions in order for data to be returned. Page Status Access Token Feature, to retrieve public data Permissions, to retrieve Page owned data Unpublished Page Access Token or User Access Token None None Published, Unrestricted App Access Token or User Access Token PPCA or PPMA pages_read_engagement pages_read_user_content pages_show_list Published, Restricted Page Access Token or User Access Token .
PPCA or PPMA pages_read_engagement pages_read_user_content pages_show_list Example curl -i -X GET "https://graph.facebook.com/PAGE-ID?access_token=ACCESS-TOKEN" Parameters Parameter Description account_linking_token UTF-8 encoded string Short lived account linking token (5 mins expiry) to get the PSID for a user-page pair Fields Field Description id numeric string The ID representing a Facebook Page. about string 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. access_token string The Page's access token. Only returned if the User making the request has a role (other than Live Contributor) on the Page. If your business requires two-factor authentication, the User must also be authenticated ad_campaign AdSet The Page's currently running an ad campaign affiliation string Affiliation of this person.
Applicable to Pages representing people. Can be read with Page Public Content Access or Page Public Metadata Access . app_id id App ID for app-owned Pages and app Pages artists_we_like string Artists the band likes. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access . attire string 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 . available_promo_offer_ids list<KeyValue:enum,list<KeyValue:string,string>> available_promo_offer_ids awards string The awards information of the film. Applicable to Films. Can be read with Page Public Content Access or Page Public Metadata Access . band_interests string Band interests. Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access . band_members string Members of the band.
Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access . best_page Page The best available Page on Facebook for the concept represented by this Page. The best available Page takes into account authenticity and the number of likes birthday string Birthday of this person. Applicable to Pages representing people. Can be read with Page Public Content Access or Page Public Metadata Access . booking_agent string Booking agent of the band.
Applicable to Bands. Can be read with Page Public Content Access or Page Public Metadata Access . breaking_news_usage null Information about the availability of daily and monthly usages of the breaking news indicator Deprecated built string Year vehicle was built. Applicable to Vehicles. Can be read with Page Public Content Access or Page Public Metadata Access . business The Business associated with this Page. Requires business_management permissions, and a page or user access token.
The person requesting the access token must be an admin of the page. can_checkin bool Whether the Page has checkin functionality enabled. Can be read with Page Public Content Access or Page Public Metadata Access . can_post bool Indicates whether the current app user can post on this Page. Can be read with Page Public Content Access or Page Public Metadata Access . category string The Page's category. e.g. Product/Service, Computers/Technology.
Can be read with Page Public Content Access or Page Public Metadata Access . Core category_list list<PageCategory> The Page's sub-categories. This field will not return the parent category. checkins unsigned int32 Number of checkins at a place represented by a Page Core company_overview string The company overview. Applicable to Companies. Can be read with Page Public Content Access or Page Public Metadata Access . connected_instagram_account IGUser Instagram account connected to page via page settings connected_page_backed_instagram_account IGUser Linked page backed instagram account for this page contact_address MailingAddress The mailing or contact address for this page.
This field will be blank if the contact address is the same as the physical address copyright_attribution_insights CopyrightAttributionInsights Insight metrics that measures performance of copyright attribution. An example metric would be number of incremental followers from attribution copyright_whitelisted_ig_partners list<string> Instagram usernames who will not be reported in copyright match systems country_page_likes unsigned int32 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 . cover CoverPhoto Information about the page's cover photo culinary_team string Culinary team of the business. Applicable to Restaurants or Nightlife. Can be read with Page Public Content Access or Page Public Metadata Access . current_location string 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 . delivery_and_pickup_option_info list<string> A Vector of url strings for delivery_and_pickup_option_info of the Page. description string The description of the Page. Can be read with Page Public Content Access or Page Public Metadata Access . Note that this value is mapped to the Additional Information setting in the Edit Page Info user interface.
Core description_html string The description of the Page in raw HTML. Can be read with Page Public Content Access or Page Public Metadata Access . differently_open_offerings list<KeyValue:enum,bool> T
The rest of this page is on the live site.