{ "openapi": "3.0.1", "info": { "title": "Facebook Groups Scraper - Posts by Date", "description": "Scrape posts from public Facebook groups with a date filter and optional comments and replies, plus the group's details for free. No login or cookies.", "version": "1.0", "x-build-id": "PdgY1ovs1bV06yZCD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/icoe-man~facebook-groups-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-icoe-man-facebook-groups-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/icoe-man~facebook-groups-scraper/runs": { "post": { "operationId": "runs-sync-icoe-man-facebook-groups-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/icoe-man~facebook-groups-scraper/run-sync": { "post": { "operationId": "run-sync-icoe-man-facebook-groups-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": [ "groupUrls" ], "properties": { "groupUrls": { "title": "Facebook group URLs", "type": "array", "description": "Links to public Facebook groups, e.g. https://www.facebook.com/groups/766064070108194, or just the group id, one per line. Up to 200 per run.", "default": [ "https://www.facebook.com/groups/766064070108194" ], "items": { "type": "string" } }, "maxPostsPerGroup": { "title": "Max posts per group", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many of each group's latest posts to collect. Each post is billed, plus a small fee per group.", "default": 25 }, "onlyNewerThan": { "title": "Only posts newer than", "type": "string", "description": "Skip posts published before this date. Use a date like 2026-01-31 or a relative value like \"7 days\". Relative values are rounded down to the start of that UTC day (hours to the start of the hour, minutes to the minute), so runs on the same day use the same window. Leave empty for no date limit." }, "includeComments": { "title": "Include comments", "type": "boolean", "description": "Also collect the comments of every post. Each comment is billed, plus a small fee per post whose comments we collect.", "default": false }, "maxCommentsPerPost": { "title": "Max comments per post", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many comments (and replies, if enabled) to collect per post when Include comments is on. Up to 24 is fastest. Above 80, a large request collects fewer posts per group, e.g. about 270 at 100 or 58 at 500 (the run's OUTPUT notes it).", "default": 24 }, "includeReplies": { "title": "Include replies", "type": "boolean", "description": "Also collect replies to comments when Include comments is on. Replies count toward the comment limit.", "default": false }, "maxDataAgeHours": { "title": "Reuse data collected within (hours)", "minimum": 0, "maximum": 720, "type": "integer", "description": "If we collected these posts within this many hours, you get them instantly at the same price. Use 0 to always collect fresh data.", "default": 24 }, "cacheOnly": { "title": "Previously collected data only (instant)", "type": "boolean", "description": "Return only posts we already collected, without waiting for live collection. Useful for AI agents with short timeouts.", "default": false } } }, "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 } } } } } } } } } }