{ "openapi": "3.0.1", "info": { "title": "Facebook Posts Search Scraper: Content Calendar Analysis", "description": "πŸ”Ž Facebook Posts Search Scraper extracts public posts by keyword, hashtag, or date β€” capturing text, author, URL, reactions, comments & shares. πŸ“ˆ Ideal for social listening, trend analysis, and competitor research. Export CSV/JSON, schedule, and scale via API. πŸš€", "version": "0.1", "x-build-id": "eedczyZjkMHXjSWQF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~facebook-posts-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~facebook-posts-search-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~facebook-posts-search-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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": { "competitorQueries": { "title": "πŸ”‘ Search Keywords / Competitor Names", "type": "array", "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nπŸ’‘ Enter topics or competitor names you want to explore!\n\nExamples: football β€’ cricket β€’ Nike β€’ Adidas\n\n🎯 Each entry = a separate search β†’ more posts discovered", "items": { "type": "string" } }, "maxPostsPerQuery": { "title": "πŸ“Š Max Posts per Query", "minimum": 1, "maximum": 5000, "type": "integer", "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nπŸ“ˆ How many posts to collect per keyword/competitor?\n\n🎚️ Range: 1 β†’ 5,000 posts. **Leave empty** for the default of 50." }, "postRecencyWindow": { "title": "⏱️ Time Filter", "enum": [ "", "24h", "7d", "30d", "90d" ], "type": "string", "description": "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nπŸ“… Filter by recencyβ€”get only fresh content!\n\n⏳ **Leave empty** for all time β€’ 24h β€’ 7d β€’ 30d β€’ 90d" }, "enablePageSummary": { "title": "πŸ“ˆ Enable page-level summary", "type": "boolean", "description": "πŸͺ„ **Leave ON** (code default) to group every discovered post by pageId and emit one summary record per page: post count, average likes/comments/shares, and the top post URL. Adds no extra network requests. Uncheck to skip (matches base, which has no page summary)." }, "enablePageProfileEnrichment": { "title": "πŸ‘€ Enrich pages with followers/category", "type": "boolean", "description": "πŸ” When ON, fetches each distinct page's public profile once to add follower count and page category to the page summary (light extra request per unique page). **Leave unchecked** for the default (off, matches base)." }, "comparePages": { "title": "πŸ₯Š Pages/queries to compare", "type": "array", "description": "πŸ“‹ One entry per line β€” page names, page URLs, or search queries. Each is searched like a normal query, then ranked against the others by average engagement (likes+comments+shares) in a separate Key-Value Store output (record COMPARISON-RANKING). Leave empty to disable.", "items": { "type": "string" } }, "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 (SERP `gl` param). 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 UI/results (SERP `hl` param). 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 / address from the page's own intro/contact card, attached as `contact` on the row. Off by default (no extra page fetches). Missing fields 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 (not charged). Set to 0 (default) to disable comment fetching entirely.", "default": 0 }, "proxyConfiguration": { "title": "🌐 Proxy Configuration", "type": "object", "description": "Optional proxy settings for Facebook requests." } } }, "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 } } } } } } } } } }