{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Search Scraper", "description": "Facebook Posts Search Scraper — Search and extract Facebook posts by keywords, including post text, authors, page details, timestamps, reactions, comments, shares, media URLs, and post links. Useful for content research, competitor analysis, audience insights, and social media monitoring.", "version": "0.4", "x-build-id": "oZlaQaphc08HO36J3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socialdataapi~facebook-posts-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socialdataapi-facebook-posts-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/socialdataapi~facebook-posts-search-scraper/runs": { "post": { "operationId": "runs-sync-socialdataapi-facebook-posts-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/socialdataapi~facebook-posts-search-scraper/run-sync": { "post": { "operationId": "run-sync-socialdataapi-facebook-posts-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": { "searchQueries": { "title": "🔎 Search keywords", "type": "array", "description": "One or more topics to search for on Facebook. Examples: football, cricket, tech news, recipes, travel. Each keyword runs its own search, so adding more keywords finds more posts.", "default": [ "" ], "items": { "type": "string" } }, "maxPosts": { "title": "🔢 Max posts per query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many posts to collect per keyword, from 1 to 5,000. Default 10. Free plan: up to 20 posts per run (all keywords together) and 200 per month; paid plans have no limit.", "default": 10 }, "postTimeRange": { "title": "📅 Post time range", "enum": [ "", "24h", "7d", "30d", "90d" ], "type": "string", "description": "Only keep posts published within this recency window, genuinely enforced before a post is saved (not just logged). Leave as all time for no filter.", "default": "" }, "targetCountry": { "title": "📍 Target country", "enum": [ "", "us", "gb", "ca", "au", "in", "de", "fr", "es", "it", "br", "mx", "ng", "za", "ae", "sg", "ph", "id", "nl", "se" ], "type": "string", "description": "Bias the search toward a country's results. Leave blank for no country bias (default).", "default": "" }, "targetLanguage": { "title": "🌍 Target language", "enum": [ "", "en", "es", "fr", "de", "pt", "ar", "hi", "id", "tl", "zh-CN", "ja", "ko", "ru", "it", "nl", "sv" ], "type": "string", "description": "Language for the search results. Leave blank to use the default (English).", "default": "" }, "enableContactLookup": { "title": "✅ Enable page contact lookup", "type": "boolean", "description": "When on, fetches each post's Facebook Page and extracts public email, phone, website, and address from the page's own intro/contact card, attached as contact on the row. Off by default (no extra page fetches). Fields that are genuinely not published are null, never fabricated.", "default": false }, "maxCommentsPerPost": { "title": "🔢 Max comments per post", "minimum": 0, "maximum": 500, "type": "integer", "description": "Maximum number of top-level comments to fetch per post, saved to a separate comments dataset for this run that is not charged. Set to 0 (default) to disable comment fetching entirely.", "default": 0 }, "proxyConfiguration": { "title": "🌐 Proxy configuration", "type": "object", "description": "Proxy used to fetch each discovered post or Page's HTML. Optional — Apify Proxy is used by default." } } }, "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 } } } } } } } } } }