{ "openapi": "3.0.1", "info": { "title": "Facebook Groups Search Scraper (members, privacy, no login)", "description": "Facebook groups search by keyword: find public groups and get member count, privacy, description, group id, and any website or email the group published in its description. No login, no cookies. Filter by group size, monitor member-count changes, pay only for the group rows you actually get.", "version": "0.2", "x-build-id": "rYIaxGf5FCeknWces" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~facebook-groups-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-facebook-groups-search", "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/datahamster~facebook-groups-search/runs": { "post": { "operationId": "runs-sync-datahamster-facebook-groups-search", "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/datahamster~facebook-groups-search/run-sync": { "post": { "operationId": "run-sync-datahamster-facebook-groups-search", "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": { "queries": { "title": "Search queries", "type": "array", "description": "Keywords to search public Facebook groups for, one per line, e.g. \"yoga kyiv\", \"expats lisbon\", \"shopify dropshipping\". Each keyword is run against a public search index restricted to facebook.com/groups.", "default": [ "yoga kyiv" ], "items": { "type": "string" } }, "groupUrls": { "title": "Group URLs", "type": "array", "description": "Known group pages to enrich directly, full URLs, e.g. \"https://www.facebook.com/groups/pythonprogramminglanguage/\". Works with the numeric id too: \"https://www.facebook.com/groups/692268140863644/\". Can be combined with Search queries or used alone.", "items": { "type": "string" } }, "resultsPerQuery": { "title": "Results per query", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many search hits to scan per keyword, e.g. 10. More hits mean more groups but a longer run; after de-duplication the number of groups is usually lower. Range 1-200.", "default": 10 }, "fetchDetails": { "title": "Open group pages", "type": "boolean", "description": "true = open each group page as a logged-out visitor to read memberCount, privacy, description and groupId (one extra request per group). false = return only the URL, slug and name found by search. Example: true.", "default": true }, "minMembers": { "title": "Min members", "minimum": 1, "type": "integer", "description": "Keep only groups with at least this many members, e.g. 500. Groups whose member count is unknown (private group, or \"Open group pages\" turned off) are skipped while this filter is set. Leave empty for no lower bound." }, "maxMembers": { "title": "Max members", "minimum": 1, "type": "integer", "description": "Keep only groups with at most this many members, e.g. 20000. Groups whose member count is unknown (private group, or \"Open group pages\" turned off) are skipped while this filter is set. Leave empty for no upper bound." }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many group rows, e.g. 20. You are charged only for rows actually pushed to the dataset.", "default": 20 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "\"scrape\" returns every matching group. \"monitor\" returns only groups that are new or whose member count / privacy changed since the previous run of the same saved task. Example: \"scrape\".", "default": "scrape" }, "monitorStateId": { "title": "Monitor state id", "type": "string", "description": "Optional state id when not running as a saved task (monitor mode)" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS URL that receives a POST with a JSON summary of the changes found in monitor mode, e.g. \"https://hooks.zapier.com/hooks/catch/123/abc\"." }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional Telegram bot token used to send monitor-mode change summaries, e.g. \"123456789:AAE...\". Leave empty to skip Telegram alerts." }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional Telegram chat id that receives the monitor-mode summaries, e.g. \"-1001234567890\" for a channel or \"123456789\" for a direct chat." } } }, "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 } } } } } } } } } }