Facebook Profile Search

API endpoint allows you to scrape the results from Facebook Profile search engine via our SerpApi service. Head to the playground for a live and interactive demo.

If you already know that you want to use Facebook Profile Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.

At a Glance

Field	Value
Name	Facebook Profile Search
Scraper	`facebook_search`
Engine	`facebook_profile_search`
Website	Facebook
Website URL	facebookprofile.com
Output Format	`json`
Version	`1.0.0`
Parameter Count	`2`
Parameter Groups	Request Controls (1), Profile ID (1)

Request Example

This is the real request body used to validate facebook_search during this docs refresh. For /v1/serp, the engine field should be the engine's scraper value.

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"facebook_search","profile_id":"Meta"}'

Response Example

The JSON below comes from the same live response. Long strings, data URLs, and large arrays were shortened so the example stays readable.

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:17:38 UTC",
    "facebook_search_url": "https://www.facebook.com/Meta/",
    "id": "01KMMKGCEVCMER3F71TR1Q41V7",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKGCEVCMER3F71TR1Q41V7.json",
    "processed_at": "2026-03-26 08:17:38 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKGCEVCMER3F71TR1Q41V7.html",
    "status": "completed",
    "total_time_taken": 16
  },
  "search_parameters": {
    "engine": "facebook_search",
    "profile_id": "Meta"
  },
  "total_credits_used": 1,
  "metadata": {
    "final_url": "https://www.facebook.com/Meta/",
    "headers": {
      "accept-ch": "viewport-width,dpr,Sec-CH-Prefers-Color-Scheme,Sec-CH-UA-Full-Version-List,Sec-CH-UA-Platform-Version,Sec-CH-UA-Model",
      "accept-ch-lifetime": "4838400",
      "alt-svc": "h3=\":443\"; ma=86400",
      "cache-control": "private, no-cache, no-store, must-revalidate",
      "content-encoding": "zstd",
      "content-security-policy": "frame-ancestors 'self';\ndefault-src blob: 'self' https://*.fbsbx.com *.facebook.com *.fbcdn.net *.facebook.net *.whatsapp.com *.whatsapp.net 'wasm-unsafe-eval';script-src *.facebook.com *.fbcdn.net *.facebook.net 127.0.0... [truncated, 2457 chars]",
      "content-type": "text/html; charset=\"utf-8\"",
      "cross-origin-opener-policy": "same-origin-allow-popups",
      "cross-origin-resource-policy": "same-origin",
      "date": "Thu, 26 Mar 2026 08:17:33 GMT",
      "_note": "14 more fields omitted"
    },
    "proxy_location": "US",
    "requested_url": "https://facebook.com/profile.php?id=100080376596424",
    "status_code": 200
  }
}

Required Parameters

If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.

Field	Type	Group	Description
`profile_id`	`string`	Profile ID	Profile ID.

Available Parameters

The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.

Request Controls

Field	Type	Required	Description
`no_cache`	`boolean`	No	Skip cached results and force a fresh fetch.

Additional Constraints

no_cache：Default: false

Profile ID

Field	Type	Required	Description
`profile_id`	`string`	Yes	Profile ID.

SERP

Engines