Pages API

Search for a Page

Updated: Apr 17, 2026
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 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.
  • Alias-based searches are not strongly supported and might not return pages that have a low fan following.

Learn More