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:

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 PageSearch nodes that meet the query's criteria. Set the q parameter value to a keyword or search term (e.g. q=Facebook). Add the fields parameter and list any fields you want included for 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/"
    },
    ...
  ]
}

Field Reference

Field NameDescription

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.