Facebook 主页搜索
Facebook Profile 搜索接口,使用 profile_id 获取指定资料页结果。
本页给出 Facebook 主页搜索 的字段定义、参数分组、必填约束以及可用过滤参数。
元数据
| 字段 | 值 |
|---|---|
| 引擎名称 | Facebook 主页搜索 |
| 原始名称 | Facebook Profile Search |
| 内部标识(scraper) | facebook_search |
| 接口标识(engine) | facebook_profile_search |
| 网站 | |
| 网站地址 | facebookprofile.com |
| 输出格式 | json |
| 版本 | 1.0.0 |
| 参数数量 | 2 |
| 参数分组 | 请求控制 (1), Profile ID (1) |
请求示例
下面的请求体是本次文档更新时实际用于验证 facebook_search 的请求。对于 /v1/serp,engine 字段应传当前引擎的 scraper 值。
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"}'响应示例
下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没,超长字符串、data URL 和大型数组做了裁剪。
{
"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
}
}必填参数
以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填,以 properties.<field>.must 为准,不以顶层 required 数组为准。
| 参数 | 类型 | 分组 | 说明 |
|---|---|---|---|
profile_id | string | Profile ID | Profile ID 参数。 |
可用参数
以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明;默认值、可选值等附加约束会列在每个分组后。
请求控制
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
no_cache | boolean | 否 | 跳过缓存结果并强制重新抓取。 |
附加约束
no_cache:默认值:false
Profile ID
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
profile_id | string | 是 | Profile ID 参数。 |
