{ "openapi": "3.0.1", "info": { "title": "Facebook User Search Scraper With Profile Bio Enrichment", "description": "Facebook User Search Scraper With Profile Bio Enrichment: Discover Facebook users by keyword and enrich results with available public profile data, bios, names, locations, profile URLs, and other details for audience research, lead generation, prospecting, and social media intelligence.", "version": "0.1", "x-build-id": "vzjH2gpy8VlTUBR7f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~Facebook-User-Search-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-Facebook-User-Search-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/api-empire~Facebook-User-Search-Scraper/runs": { "post": { "operationId": "runs-sync-api-empire-Facebook-User-Search-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/api-empire~Facebook-User-Search-Scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-Facebook-User-Search-Scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchNames": { "title": "🧑‍🦰 Names or Keywords to Search", "type": "array", "description": "📝 One or more names/keywords. Each is searched via Google to discover matching Facebook profile URLs, which are then enriched with demographics & bio data. (Re-expresses the base's `queries` field — `queries` still works if you post it directly.)", "items": { "type": "string" } }, "maxProfilesToEnrich": { "title": "📇 Max Profiles to Enrich", "minimum": 1, "maximum": 50000, "type": "integer", "description": "🎚️ Maximum number of Facebook profiles to discover and enrich per run. Default is 10." }, "includeBioDemographics": { "title": "🪪 Include Demographics & Bio Enrichment", "type": "boolean", "description": "🧬 When ON (default), fetches each profile's about_contact_and_basic_info, about_places, about_family_and_relationships and about_details sub-pages and merges bio, current city/hometown, relationship + partner link, gender/birthday/languages/category, verified badge and follower count into the output — plus the derived profileCompletenessScore and approxAge. Turn OFF to run the faster base-only scrape.", "default": true }, "directProfileLinks": { "title": "Profile URLs", "type": "array", "description": "➕ Facebook profile URLs to enrich directly, alongside any search results. Leave empty to rely only on search. (Re-expresses the base's `startUrls` — `startUrls` still works if posted directly.)", "items": { "type": "string" } }, "fetchDelaySeconds": { "title": "⏱️ Delay Between Requests (sec)", "minimum": 0, "maximum": 10, "type": "integer", "description": "🕒 Seconds to wait between each profile's requests (politeness delay, 0-10). Default is 1. (Re-expresses the base's `requestDelay`.)" }, "networkConfiguration": { "title": "Proxy configuration", "type": "object", "description": "🔒 Search uses a dedicated Google SERP proxy. For Facebook profile + sub-page requests: no proxy by default, auto-escalates datacenter → residential if blocked. (Re-expresses the base's `proxyConfiguration`.)" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }