Graph API Version

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

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 StatusAccess TokenFeature, to retrieve public dataPermissions, 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

ParameterDescription
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

FieldDescription
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

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>>