{ "openapi": "3.0.1", "info": { "title": "Facebook Email Finder & Contacts Scraper", "description": "Discover public email contacts behind Facebook profiles and pages by keyword and location. Pay only for each contact delivered.", "version": "1.0", "x-build-id": "CyU0VM4c6kFHsyHzq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/receptional_blender~facebook-contact-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-receptional_blender-facebook-contact-finder", "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/receptional_blender~facebook-contact-finder/runs": { "post": { "operationId": "runs-sync-receptional_blender-facebook-contact-finder", "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/receptional_blender~facebook-contact-finder/run-sync": { "post": { "operationId": "run-sync-receptional_blender-facebook-contact-finder", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Keywords", "minItems": 1, "type": "array", "description": "Search terms used to find relevant Facebook profiles and pages (names, niches, business types, handles). At least one keyword is required. Each keyword is searched independently.", "items": { "type": "string" } }, "locations": { "title": "Locations (optional)", "type": "array", "description": "Optional list of locations used to refine each keyword search, e.g. \"New York\" or \"London\". When provided, every keyword is searched once per location.", "items": { "type": "string" } }, "gmail": { "title": "Include Gmail", "type": "boolean", "description": "Target @gmail.com addresses.", "default": true }, "yahoo": { "title": "Include Yahoo", "type": "boolean", "description": "Target @yahoo.com addresses.", "default": true }, "outlook": { "title": "Include Outlook / Hotmail", "type": "boolean", "description": "Target @outlook.com and @hotmail.com addresses.", "default": true }, "aol": { "title": "Include AOL", "type": "boolean", "description": "Target @aol.com addresses.", "default": true }, "icloud": { "title": "Include iCloud", "type": "boolean", "description": "Target @icloud.com addresses.", "default": true }, "protonmail": { "title": "Include ProtonMail", "type": "boolean", "description": "Target @protonmail.com addresses.", "default": true }, "other": { "title": "Include other providers", "type": "boolean", "description": "Also target the custom domains listed under \"Extra email providers\".", "default": false }, "extraEmailProviders": { "title": "Extra email providers", "type": "array", "description": "Custom email domains to target when \"Include other providers\" is on, e.g. \"company.com\". Enter the domain without the leading @.", "items": { "type": "string" } }, "maxProfiles": { "title": "Maximum contacts", "minimum": 1, "type": "integer", "description": "Upper bound on the number of contacts delivered in one run. Start small to validate your settings, then raise it. Larger values crawl deeper but cost more compute and time.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy applied to every request. Residential proxy is strongly recommended for search engines; it reduces blocking and rate limiting.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }