Facebook Search Pages

Search public Facebook Pages by name.

GET/api/v1/facebook/search-pages

Alpha: this endpoint is new and its response fields may still change.

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request parameters

Search public Facebook Pages by name.

Parameter	Type	Description
`query`required	string	Page name or phrase to look up.Up to 200 characters.
`limit`	integer	Maximum Page suggestions per response; fewer may be available.Default: 15.Range: 1 to 15.
`country`	string	Two-letter country preference for Page suggestions, such as US, GB or CA. Does not restrict a Page's location.Default: US.
`ad_type`	"ALL" \| "POLITICAL_AND_ISSUE_ADS"	Ad category for Page suggestions: all ads or political and issue ads.Default: ALL.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: pages. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/facebook/search-pages?query=NASA&limit=15&country=US&ad_type=ALL" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "query": "NASA",
  "limit": 15,
  "country": "US",
  "ad_type": "ALL"
});
const res = await fetch(`https://serpfast.com/api/v1/facebook/search-pages?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "query": "NASA",
  "limit": 15,
  "country": "US",
  "ad_type": "ALL"
}
res = requests.get(
    "https://serpfast.com/api/v1/facebook/search-pages",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())