Facebook Page lookup API
Look up Facebook Pages and profiles by name with Facebook's own quick search. A name lookup that returns basic identity fields only: name, URL, profile image, Facebook id, and verified status. Matches can include personal profiles as well as Pages. For full Page details (category, followers, phone, website), use facebook.search_pages.
$9.75/1k req, pay per request, no subscription.
{"id": "18342518979","name": "NASA","url": "https://www.facebook.com/NASA","image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nasa_profile.jpg?ccb=1-7&_nc_sid=abc123","isVerified": true}
Pricing and providers
Facebook Page lookup API pricing: one API, 2 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Facebook page lookup in one request
This sample shows 8 of 9 fields. See every field
{
"found": true,
"data": {
"items": [
{
"id": "18342518979",
"name": "NASA",
"url": "https://www.facebook.com/NASA",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nasa_profile.jpg?ccb=1-7&_nc_sid=abc123",
"isVerified": true
},
{
"id": "170928549604",
"name": "NASA Jet Propulsion Laboratory",
"url": "https://www.facebook.com/NASAJPL",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nasajpl_profile.jpg?ccb=1-7&_nc_sid=def456",
"isVerified": true
},
{
"id": "222846867752",
"name": "NASA Kennedy",
"url": "https://www.facebook.com/NASAKennedy",
"image": "https://scontent.xx.fbcdn.net/v/t39.30808-1/nasakennedy_profile.jpg?ccb=1-7&_nc_sid=ghi789",
"isVerified": false
}
]
}
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-11-10 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- querystring
NASA
Name to look up, as you would type it into Facebook's search box (e.g. NASA or plumber chicago).
- limitinteger
5
Maximum number of matches to return (1-7, default 7). Facebook's quick search answers a name with at most 7 matches.
Response
JSON, one example value per field.
Pages and profiles whose name matches the query, in Facebook's order. Matches can include personal profiles as well as Pages.
- idstring
18342518979
Numeric Facebook id of the Page or profile, as a string. Populated whenever the provider has data for the entity.
- imagestring
https://scontent.xx.fbcdn.net/v/t39.30808-1/nasa_profile.jpg?ccb=1-7&_nc_sid=abc123
Profile picture URL. Facebook signs it in the query string, so it works only as returned and expires. Populated whenever the provider has data for the entity.
- isVerifiedboolean
true
Whether Facebook shows the verified badge on this Page or profile.
- namestring
NASA
Display name of the Page or profile. Populated whenever the provider has data for the entity.
- urlstring
https://www.facebook.com/NASA
Facebook URL of the Page or profile. Populated whenever the provider has data for the entity.
- foundboolean
true
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Facebook Page lookup API
The AnyAPI Facebook Page lookup API returns Facebook page lookup data as normalized JSON from one POST call to /v1/run/facebook.page_lookup. Look up Facebook Pages and profiles by name with Facebook's own quick search. A name lookup that returns basic identity fields only: name, URL, profile image, Facebook id, and verified status. Matches can include personal profiles as well as Pages. For full Page details (category, followers, phone, website), use facebook.search_pages. AnyAPI routes each request across 2 sources and falls back automatically when one fails. It costs from $9.75 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Facebook page lookup calls through AnyAPI succeeded, with a median response time of 3.0 seconds across 279 measured calls.
