{ "openapi": "3.0.1", "info": { "title": "Facebook Group Post Scraper With Engagement Analyzer", "description": "Facebook Group Post Scraper gathers posts from public Facebook groups with full details. Collect text, media, authors, timestamps, reactions, and comments. Ideal for research, community insights, monitoring discussions, and powering data-driven automation workflows.", "version": "0.1", "x-build-id": "vISYug9dcnY55H138" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~facebook-group-post-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-facebook-group-post-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-group-post-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-facebook-group-post-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-group-post-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-facebook-group-post-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": [ "groupUrl" ], "properties": { "groupUrl": { "title": "🎯 Group to Analyze", "type": "string", "description": "πŸ“Œ Paste the full Facebook group URL to analyze.\n\nExample: https://www.facebook.com/groups/cheapmealideas\n\nπŸ’‘ The group must be public (or accessible to you)." }, "count": { "title": "πŸ“₯ Posts to Analyze (sample size)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "🎯 How many posts to pull into the leaderboard before ranking.\n\nπŸ’‘ A larger sample gives a more representative ranking.\n\n⚑ Range: 1-10,000 posts.", "default": 20 }, "minEngagement": { "title": "πŸ”½ Minimum Engagement Score", "minimum": 0, "type": "integer", "description": "🧹 Drop any post whose engagementScore (reactions + 2Γ—comments + 3Γ—shares) is below this value.\n\nπŸ’‘ Set to 0 to keep every post (default). Raise it to focus only on posts that actually moved.", "default": 0 }, "topN": { "title": "πŸ… Keep Only Top N Performers", "minimum": 1, "type": "integer", "description": "βœ‚οΈ After ranking, keep only the top N posts by engagement score.\n\nπŸ’‘ Leave empty to keep the whole ranked leaderboard." }, "sortType": { "title": "πŸ”€ Feed Fetch Order", "enum": [ "new_posts", "most_relevant", "recent_activity" ], "type": "string", "description": "πŸ“‹ How posts are pulled from Facebook BEFORE the engagement ranking is applied.\n\nπŸ†• New posts - Latest posts first (chronological)\n⭐ Most relevant - Top posts by Facebook's own ranking\nπŸ”₯ Recent activity - Posts with recent comments/interactions\n\nπŸ’‘ The final output is always re-ranked by engagement score regardless of this setting.", "default": "new_posts" }, "scrapeUntil": { "title": "πŸ“… Only Analyze Posts Newer Than", "type": "string", "description": "⏰ Only include posts created after this date in the leaderboard.\n\nβœ… Leave empty to analyze all fetched posts.\n\nπŸ“ Formats: YYYY-MM-DD or YYYY-MM-DD HH:MM:SS (UTC)." }, "proxy": { "title": "πŸ”’ Proxy Settings", "type": "object", "description": "🌐 Configure proxy settings for fetching.\n\nβœ… Recommended: Use Apify Proxy (enabled 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 } } }, "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 } } } } } } } } } }