{ "openapi": "3.0.1", "info": { "title": "Facebook Groups Scraper - Posts, Reactions & Authors", "description": "Scrape posts from public Facebook groups by URL, name or ID: text, date, author with group badges, reactions by type, comments, shares, top comments, photos with image descriptions, videos, links and buy-and-sell listings. Free date filter. No login, no cookies.", "version": "0.1", "x-build-id": "4ilcOdjqUkpLf9H64" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/eiv~facebook-groups-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-eiv-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/eiv~facebook-groups-scraper/runs": { "post": { "operationId": "runs-sync-eiv-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/eiv~facebook-groups-scraper/run-sync": { "post": { "operationId": "run-sync-eiv-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", "properties": { "targets": { "title": "Facebook groups", "type": "array", "description": "One per line. Group URLs (facebook.com/groups/), group share links (facebook.com/share/g/...), group post URLs (their group is scraped), or bare group ids or names. Public groups only.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (for chaining Actors)", "type": "array", "description": "The same groups in the URL-list shape other Actors output (and that apify/facebook-groups-scraper takes), so a previous Actor's results can be fed straight in. Use this or the field above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxPostsPerGroup": { "title": "Posts per group", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Posts to collect from each group, in the order chosen below. Facebook serves 3 posts per request (about a second), so 300 posts take about 2 minutes per group; groups run in parallel.", "default": 50 }, "maxItems": { "title": "Max posts in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Stop after this many posts across all groups. You pay per post, so this is also your cost cap for the run.", "default": 1000 }, "sortOrder": { "title": "Post order", "enum": [ "NEW_POSTS", "RECENT_ACTIVITY", "TOP_POSTS", "LISTINGS" ], "type": "string", "description": "The order of the group's own sort menu. \"New posts\" starts with the latest, \"Newest activity\" with posts that got comments lately, \"Most relevant\" with Facebook's top posts. \"Buy and sell listings\" returns only for-sale posts (in buy and sell groups). A date limit below reads new posts.", "default": "NEW_POSTS" }, "postsNewerThan": { "title": "Only posts published after", "type": "string", "description": "Optional. Keep only posts published on or after this date, e.g. 2026-01-31 or \"7 days\" for the last week. Posts are read newest first and each group stops at the first older one, so old posts are neither fetched nor charged. Free, unlike some other group scrapers." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Keep the default (Apify residential). Facebook answers group feeds only to residential addresses: Apify's own and datacenter addresses are refused on the first request. Residential traffic is included in the price per post.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxConcurrency": { "title": "Concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many groups are processed at the same time. Each group's pages are read one after another.", "default": 5 }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait for one response before giving up on it (and moving to another address).", "default": 30 }, "maxRetries": { "title": "Retries per request", "minimum": 0, "maximum": 5, "type": "integer", "description": "Retries for failed connections when no proxy is used. With a proxy, a refused or failed request moves to another address instead.", "default": 2 } } }, "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 } } } } } } } } } }