{ "openapi": "3.0.1", "info": { "title": "Facebook Search Scraper [UPDATED]", "description": "Extract and analyze public Facebook posts with detailed engagement metrics, author insights, and rich media data. Perfect for market research, brand monitoring, and competitive analysis. Get structured JSON output with post content, reactions, comments, shares, and hashtags—all in one place", "version": "0.0", "x-build-id": "KRHgGj1NoO6oWW24Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~apify-facebook-post-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-apify-facebook-post-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/memo23~apify-facebook-post-search-scraper/runs": { "post": { "operationId": "runs-sync-memo23-apify-facebook-post-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/memo23~apify-facebook-post-search-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-apify-facebook-post-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", "required": [ "searchTerms", "maxItems" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Plain keywords (e.g. Pub). Each term is turned into a Google search (competitor-style site:facebook.com page discovery), then Facebook pages are fetched.", "items": { "type": "string" } }, "locations": { "title": "Location (applied to each search term)", "type": "array", "description": "Optional. If set, each entry is combined with every search term (e.g. Pub × Oakmont PA). Leave empty to search by term only.", "items": { "type": "string" } }, "monitoringMode": { "title": "Run in monitoring mode where only newly posts compared to previous runs will be scraped", "type": "boolean", "description": "If checked, it will only scrape newly posts compared to what has been scraped in previous runs.", "default": false }, "startDate": { "title": "Only scrape posts newer than [date]", "type": "string", "description": "Format should be YYYY-MM-DD, e.g., 2025-02-20" }, "maxItems": { "title": "Max items (dataset rows)", "type": "integer", "description": "Max Facebook page/post rows pushed to the dataset. Also caps how many Facebook URLs are taken from each Google results page, and scales how many extra Google SERP pages (start=10, 20, …) are opened (roughly one extra page per 10 max items, up to 20).", "default": 20 }, "minDelay": { "title": "Min delay for scroll", "type": "integer", "description": "Minimum delay to wait before scrolling to the bottom of the page. This is useful to avoid getting blocked by Facebook. The delay is in seconds.", "default": 5 }, "maxDelay": { "title": "Max delay for scroll", "type": "integer", "description": "Maximum delay to wait before scrolling to the bottom of the page. This is useful to avoid getting blocked by Facebook. The delay is in seconds.", "default": 10 } } }, "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 } } } } } } } } } }