{ "openapi": "3.0.1", "info": { "title": "Facebook Post 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": "YG4VYj6y3YaatDD0R" }, "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": "Business categories used to DISCOVER Facebook pages via Google (e.g. Pub, Bakery, Estate agent). This is not a post-text filter — to keep only results whose text contains a phrase, use \"Only keep results containing text\" below.", "items": { "type": "string" } }, "locations": { "title": "Location (applied to each search term)", "type": "array", "description": "Optional place NAME combined with every search term (e.g. Pub × Oakmont PA). Enter a name like \"Manchester\" or \"United Kingdom\" — not a numeric Facebook ID. If a numeric ID is entered, the actor tries to resolve it to the place name and stops with a clear error when it cannot. Leave empty to search by term only.", "items": { "type": "string" } }, "filterByText": { "title": "Only keep results containing text", "type": "array", "description": "Optional, case-insensitive. Keep only rows whose post text or page title/intro contains at least one of these phrases (e.g. \"new premises\"). Rows with no matching text are skipped. Leave empty to keep everything found.", "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 } } } } } } } } } }