Search for a Page

This guide explains how to search for Facebook Pages. Find Pages to @Mention, manage Page locations, and tag a Page to show branded content.

Before You Start

You will need:

Search

Send a GET request to the /search endpoint with type set to place and q set to the Page name or keyword such as "coffee shop".

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

On success, your app receives the following 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

FieldDescription

id

numeric string

The ID of the Page

is_eligible_for_branded_content

bool

Indicates whether the Page is eligible for the branded content tool

is_unclaimed

bool

Indicates whether a Page is unclaimed by a business

link

string

The URL of the Facebook Page

location
array

The location of the business represented by the Facebook Page

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 address of the business represented by the Facebook Page

zip

string

The zip code of the business represented by the Facebook Page

name

string

The name of the Facebook Page

verification_status

string

Indicates whether the Facebook Page is verified

Rate Limits

Rate limits are applied to search.

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