Search for a Page

This guide explains how to get information about Facebook Pages including names, locations, and more. Find Pages to @Mention, Page locations, and tag a Page to show branded content.

Before You Start

You will need:

A User access token and the app secret if the app user is logged into Facebook.
An App access token with the Page Public Metadata Access feature if the app user is not logged into Facebook.

Sample Request

curl -i -X GET \
  "https://graph.facebook.com/pages/search?q=Facebook
  &fields=id,name,location,link
  &access_token={access-token}"

Returns a list of Pages that meet the query's criteria. Set the q parameter value to a keyword or search term (e.g. q=Facebook). Use the fields parameter to list any fields you want included with each Page returned in the response.

Sample Response

{
  "data": [
    {
      "id": "309968765748101",
      "name": "Facebook HQ",
      "location": {
        "city": "Menlo Park",
        "country": "United States",
        "latitude": 37.483183,
        "longitude": -122.149999,
        "state": "CA",
        "street": "1 Hacker Way",
        "zip": "94025"
      },
      "link": "https://www.facebook.com/Facebook-HQ-166793820034304/"
    },
    {
      "id": "194776097220801",
      "name": "Facebook Seattle",
      "location": {
        "city": "Seattle",
        "country": "United States",
        "latitude": 47.628293260721,
        "longitude": -122.34263420105,
        "state": "WA",
        "street": "1101 Dexter Ave N",
        "zip": "98109"
      },
      "link": "https://www.facebook.com/fbseattle/"
    },
    ...
  ]
}

Fields

Field Name	Description
`id` int	The ID of the Facebook Page.
`is_eligible_for_branded_content` boolean	Display whether the Facebook Page is eligible to post branded content.
`is_unclaimed` boolean	Display whether a Facebook Page that was automatically generated has been claimed by the business it represents, `is_unclaimed=false`, or not, `is_unclaimed=true`.
`link` uri	The link to the Facebook Page.
`location` array	The physical location of the business represented by the Facebook Page, if applicable.
`city` string	The city where the business represented by the Facebook Page is located.
`country` string	The country where the business represented by the Facebook Page is located.
`latitude` float	The latitude of the business represented by the Facebook Page.
`longitude` float	The longitude of the business represented by the Facebook Page.
`state` string	The state where the business represented by the Facebook Page is located.
`street` string	The street on which the business represented by the Facebook Page is located.
`zip` int	The postal code of the business represented by the Facebook Page.
`name` string	The name of the Facebook Page.
`verification_status` string	The verification status of the Facebook Page that represents a business, `blue_verified` or `not_verified`.

Limitations

The GET /search?type=place endpoint is deprecated in v8.0+ and in all versions on Nov. 2, 2020.
This endpoint does not return a Page's profile picture. Please see the Page Reference for information on getting a Page's profile picture.

Rate Limits

Apps can make up to 500 calls per User per 24 hours. Apps that excessively or persistently exceed their rate limits may be disabled. If your app reaches this limit you will see error code 613.