{ "openapi": "3.0.1", "info": { "title": "Facebook Groups Scraper", "description": "Facebook Groups Scraper: Discover Facebook groups and extract names, descriptions, member counts, categories, locations, activity signals, and group URLs. Build structured datasets for community research, audience discovery, competitor analysis, social media marketing, and lead generation.", "version": "0.1", "x-build-id": "4vtcciKh0rW6f2ed7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~Facebook-Groups-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-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/scrapier~Facebook-Groups-Scraper/runs": { "post": { "operationId": "runs-sync-scrapier-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/scrapier~Facebook-Groups-Scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-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": [ "startUrls" ], "properties": { "startUrls": { "title": "🔗 Facebook Group URLs", "type": "array", "description": "One or more public Facebook group URLs, e.g. `https://www.facebook.com/groups/cheapmealideas/`. Only public groups are supported without login.", "items": { "type": "string" } }, "resultsLimit": { "title": "📊 Number of Posts to Scrape", "minimum": 1, "type": "integer", "description": "Maximum number of posts to collect across all group URLs. You are only charged per post row that is actually saved.", "default": 20 }, "viewOption": { "title": "🔄 Post Sorting", "enum": [ "CHRONOLOGICAL", "RECENT_ACTIVITY", "TOP_POSTS", "CHRONOLOGICAL_LISTINGS" ], "type": "string", "description": "How the group feed is sorted while scraping:\n\n- **CHRONOLOGICAL** — newest posts by publish date\n- **RECENT_ACTIVITY** — posts with the latest activity first\n- **TOP_POSTS** — most engaging posts first\n- **CHRONOLOGICAL_LISTINGS** — for Buy/Sell groups", "default": "CHRONOLOGICAL" }, "searchGroupKeyword": { "title": "🔍 Text Filter (keyword)", "type": "string", "description": "Keep only posts whose text contains this keyword. This is a client-side filter applied to the scraped feed — it is not a Facebook search, so short terms (1–2 letters) match more posts.", "default": "" }, "searchGroupYear": { "title": "📅 Text Filter (year)", "type": "string", "description": "Keep only posts published in this year (e.g. `2025`). Client-side filter; use together with the keyword filter above.", "default": "" }, "onlyPostsNewerThan": { "title": "📅 Posts Newer Than", "pattern": "^$|^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Stop scraping when posts are older than this date. Accepts an absolute date (`YYYY-MM-DD`, e.g. `2025-01-15`) or a relative period (`7 days`, `2 weeks`, `1 month`, `1 year`)." }, "cookieString": { "title": "🍪 Facebook Cookie String", "type": "string", "description": "Optional. Cookie header copied from a logged-in browser session (DevTools → Application → Cookies → `https://www.facebook.com`). Must include at least `c_user` and `xs`, e.g. `c_user=100000...; xs=12%3A...; datr=...`. Use a secondary account — cookies grant access to that account. Leave empty for logged-out scraping (recommended for public groups)." } } }, "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 } } } } } } } } } }