Facebook API: Search places (v1)

Searches Facebook's public local businesses and places by free text and returns each place's id, name, URL, profile picture and description. Paginate with cursor from pageInfo. An empty places array means no public match.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

Free-text search phrase.

Length1 <= length <= 200

cursor?string

Opaque pagination cursor from a previous response.

count?integer

Records per page. Facebook caps most surfaces well below this.

Range1 <= value <= 50

curl -X GET "https://example.com/v1/facebook/search/places?query=pizza+new+york" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "places": [      {        "id": "string",        "name": "string",        "url": "string",        "profilePictureUrl": "string",        "isVerified": true,        "primaryText": "string",        "description": "string"      }    ],    "pageInfo": {      "cursor": "string",      "hasNextPage": true    }  },  "details": {    "reason": "string",    "message": "string"  }}