{ "openapi": "3.0.1", "info": { "title": "Facebook Group Posts Scraper (Details)", "description": "The Facebook Group Posts And Details Scraper extracts posts, comments, reactions, and group metadata from public Facebook groups. Export structured JSON for research, analytics, automation, and monitoring. Fast, reliable, and built for scalable Facebook data scraping workflows. ๐Ÿš€", "version": "0.1", "x-build-id": "sRj9jntQk7kSre6Io" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapapi~facebook-group-posts-scraper-details/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapapi-facebook-group-posts-scraper-details", "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/scrapapi~facebook-group-posts-scraper-details/runs": { "post": { "operationId": "runs-sync-scrapapi-facebook-group-posts-scraper-details", "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/scrapapi~facebook-group-posts-scraper-details/run-sync": { "post": { "operationId": "run-sync-scrapapi-facebook-group-posts-scraper-details", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "๐Ÿ”— Facebook Group URLs or Identifiers", "type": "array", "description": "๐Ÿ“‹ Enter one or more Facebook group URLs or group identifiers.\n\n๐Ÿ’ก Examples:\nโ€ข Full URL: https://www.facebook.com/groups/germtheory.vs.terraintheory\nโ€ข Group ID: germtheory.vs.terraintheory\n\nโœจ You can add multiple groups to scrape them all in one run!", "items": { "type": "string" } }, "monitoringMode": { "title": "๐Ÿ‘๏ธ Monitoring Mode (only new posts)", "type": "boolean", "description": "๐Ÿ”” **Track only fresh content**.\n\nWhen enabled, the Actor remembers which post IDs it has already seen and **skips duplicates in future runs**.\nPerfect for monitoring active groups every day without reโ€‘processing old posts.\n\n๐Ÿ—‚๏ธ Uses Apify Keyโ€‘Value Store under the hood to persist seen post IDs.", "default": false }, "maxPosts": { "title": "๐Ÿ“Š Maximum Posts (total across all groups)", "minimum": 10, "type": "integer", "description": "๐ŸŽฏ **Global cap** across the whole run (same as standalone `group.py`).\n\nWith **multiple** `startUrls`, the cap is **split** across groups (`split_quota`) and results are merged, then capped at this value.\nWith **one** group, that group gets the full quota.\n\n๐Ÿ“Œ Minimum: **10**.\n๐Ÿ’ก Example: `maxPosts: 50` with 2 groups โ†’ ~25 posts per group, **โ‰ค50** total in the dataset.", "default": 10 }, "sortOrder": { "title": "๐Ÿ”„ Sort Order", "enum": [ "RECENT_POSTS", "TOP_POSTS", "RECENT_ACTIVITY", "CHRONOLOGICAL" ], "type": "string", "description": "Sorting strategy for the group feed (`sortingSetting` in GraphQL variables).", "default": "RECENT_ACTIVITY" }, "startDate": { "title": "๐Ÿ“… Filter Posts by Date", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "๐Ÿ—“๏ธ Only scrape posts newer than the selected date.\n\n๐Ÿ“ Format: YYYY-MM-DD (e.g., 2025-02-20)\n\n๐Ÿ’ก Leave empty to scrape all available posts regardless of date\nโœจ Useful for getting only recent content or posts from a specific time period" }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy", "type": "object", "description": "Proxy settings (optional). This actor always uses residential proxy regardless of your choice. Configure Apify Proxy credentials if needed." } } }, "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 } } } } } } } } } }