{ "openapi": "3.0.1", "info": { "title": "Facebook Page Search & API: Business Leads Without Login", "description": "Search Facebook pages by keyword and city (\"dentist chicago\") without login or cookies. Each page with exact followers, category, email (also from its website), phone, website, address, rating, Instagram. Only new pages mode for weekly lead lists.", "version": "0.1", "x-build-id": "T4fqMmBBzNENUd2S4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~facebook-page-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-facebook-page-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/s_actors~facebook-page-search-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-facebook-page-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/s_actors~facebook-page-search-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-facebook-page-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": { "queries": { "title": "🔎 Searches", "type": "array", "description": "One search per line: a business type or keyword, best with a city, e.g. \"dentist chicago\", \"yoga studio berlin\", \"coffee roaster portland\", \"real estate agent miami\". Each search returns up to \"Pages per search\" Facebook pages.", "items": { "type": "string" } }, "country": { "title": "🌍 Country (Google market)", "enum": [ "us", "gb", "ca", "au", "nz", "ie", "in", "sg", "za", "ph", "de", "at", "ch", "fr", "be", "nl", "es", "pt", "it", "se", "dk", "no", "fi", "pl", "cz", "br", "mx", "ar", "jp", "kr", "tr", "ae" ], "type": "string", "description": "The Google market the pages are searched in: pick the country of your city (\"berlin\" on United States finds Berlin, MD and Berlin, NJ). The language follows the country.", "default": "us" }, "maxPagesPerQuery": { "title": "📄 Pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum Facebook pages returned for one search (1-100). Google lists about 100 results for a search, so a busy niche gives 50-80 pages; for more, add searches by district or synonym (\"dentist lincoln park chicago\", \"dental clinic chicago\").", "default": 50 }, "onlyNew": { "title": "🆕 Only new pages (since earlier runs)", "type": "boolean", "description": "Remember the pages returned for each search (same text and country) and skip them in later runs: schedule the same searches weekly and get only the pages you have not seen. Skipped pages are free.", "default": false }, "searchWebsite": { "title": "🌐 Also find emails on the page's website", "type": "boolean", "description": "Opens the website listed on the Facebook page (its home page and, while no email is found, its contact / imprint pages) and adds the emails found there. Included in the price.", "default": true }, "onlyWithEmail": { "title": "📧 Only pages with an email", "type": "boolean", "description": "Return only pages with at least one email (from Facebook or the website). Pages without one are then left out and free.", "default": false }, "checkMailServer": { "title": "✅ Check that the email domain receives mail", "type": "boolean", "description": "Looks up the mail server (MX record) of every email domain: addresses on domains that cannot receive mail are dropped.", "default": true }, "includeProfiles": { "title": "👤 Include personal profiles", "type": "boolean", "description": "Google also finds personal profiles of people; by default only Pages (and profiles with a business category) are returned.", "default": false }, "contactPages": { "title": "📄 Contact pages to open per website", "minimum": 0, "maximum": 5, "type": "integer", "description": "When the home page has no email: how many contact-like pages of the same site to open (contact, imprint, about...). 0 = home page only.", "default": 2 }, "maxConcurrency": { "title": "⚡ Parallel pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many Facebook pages are opened at the same time.", "default": 8 } } }, "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 } } } } } } } } } }