Pages Search

Search for Pages on Facebook. Find Pages to @Mention, manage Page locations, and tag a Page to show branded content.

GET graph.facebook.com/pages/search?
    q={your-query}

Requirements

A User access token
Your App must undergo App Review for the Page Public Content Access feature permission

Fields

Field	Description	Values
`id`	The Page's ID	numeric string
`is_eligible_for_branded_content`	Indicates whether the page is eligible for the branded content tool	bool
`is_unclaimed`	Indicates whether the Page is unclaimed	bool
`link`	The Page's Facebook URL	string
`location`	The business' location represented by this Facebook Page	array
`city`	City	string
`country`	Country	string
`latitude`	Latitude	float
`longitude`	Longitude	float
`state`	State	string
`street`	Street address	string
`zip`	Zip	string
`name`	The Page's name	string
`verification_status`	Shows whether this Page is verified. Pages with a large number of followers can be manually verified by Facebook as having an authentic identity	string

Searching

Sample Request

curl -i -X GET \
  "https://graph.facebook.com/v3.0/pages/search?&q=Nomi
  &fields=id,name,verification_status,location,link,is_unclaimed,is_eligible_for_branded_content
  &access_token=user-access-token"

Sample Response

{
  "data": [
    {
      "id": "243272457279",
      "name": "Sake Nomi",
      "verification_status": "not_verified",
      "location": {
        "city": "Seattle",
        "country": "United States",
        "latitude": 47.60102,
        "longitude": -122.33523,
        "state": "WA",
        "street": "76 S Washington St",
        "zip": "98104"
      },
      "link": "https://www.facebook.com/SakeNomiSeattle/",
      "is_unclaimed": false
      "is_eligible_for_branded_content": false
    },
    ...
  ]
}

Rate Limiting

Rate limiting applied to Search for Pages apps are 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. Visit our Rate Limiting Guide for more information on Graph API Rate Limits.