{
"openapi": "3.0.1",
"info": {
"title": "Facebook Group Posts & Comments Scraper",
"description": "Every post from any public Facebook group with its complete comment thread — nested replies included and correctly attached to their parent comment. No login, no cookies, no second Actor. Large groups resume across runs, so you never pay twice for the same post.",
"version": "0.0",
"x-build-id": "Dme64jOe5NvgU7e6g"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/amrhassan25~facebook-actor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-amrhassan25-facebook-actor",
"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/amrhassan25~facebook-actor/runs": {
"post": {
"operationId": "runs-sync-amrhassan25-facebook-actor",
"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/amrhassan25~facebook-actor/run-sync": {
"post": {
"operationId": "run-sync-amrhassan25-facebook-actor",
"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 URLs of public Facebook groups. Private groups cannot be scraped without logging in, which this Actor deliberately never does.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxPosts": {
"title": "Max posts per group",
"minimum": 0,
"type": "integer",
"description": "How many posts to scrape from each group. Set to 0 to keep going until the group feed is exhausted.",
"default": 20
},
"maxCommentsPerPost": {
"title": "Max comments per post",
"minimum": 0,
"type": "integer",
"description": "How many comments to collect per post. Set to 0 to collect all comments. Replies count toward this limit.",
"default": 0
},
"includeReplies": {
"title": "Include replies to comments",
"type": "boolean",
"description": "Expand nested reply threads under each comment. Turn off to collect only top-level comments and run faster.",
"default": true
},
"onlyPostsNewerThan": {
"title": "Only posts newer than",
"type": "string",
"description": "Stop paginating once posts get older than this. Accepts an absolute date (2026-07-01) or a relative period (7 days, 3 months). Leave empty for no date limit."
},
"sortBy": {
"title": "Feed sorting",
"enum": [
"CHRONOLOGICAL",
"RECENT_ACTIVITY",
"TOP_POSTS"
],
"type": "string",
"description": "How the group feed is ordered while scraping. CHRONOLOGICAL returns newest posts first.",
"default": "CHRONOLOGICAL"
},
"commentsOrder": {
"title": "Comment ordering",
"enum": [
"ALL",
"NEWEST",
"TOP"
],
"type": "string",
"description": "ALL returns every comment including low-ranked ones and is the most complete. NEWEST orders by time, TOP returns Facebook's ranked selection.",
"default": "ALL"
},
"flattenComments": {
"title": "One row per comment",
"type": "boolean",
"description": "Off (default): one dataset item per post, with comments nested inside it. On: every comment becomes its own row, which suits CSV and Excel exports.",
"default": false
},
"resumeFromLastRun": {
"title": "Resume from where the last run stopped",
"type": "boolean",
"description": "Facebook throttles anonymous traffic, so a very large group can outlast a single run. Turn this on to continue that group's feed from the position the previous run reached, instead of paying to collect the same posts again.
How to use it: run once with this off, then read the last line of the log. It names how the run ended — [exhausted] or [end-of-feed] means the whole feed was served and there is nothing left; [feed-empty], [feed-repeating], [throttled] or [error] means the position was saved and running again with this option on will go deeper. Repeat until you see [exhausted].
This resumes deeper into older posts — it is not how you collect newly published ones, which is what \"Only posts newer than\" is for. The position is recorded on every run whether or not this is on, so you can switch it on after a run has already stopped, and it is discarded only once Facebook confirms the feed is finished.",
"default": false
},
"maxConcurrency": {
"title": "Max concurrency",
"minimum": 1,
"maximum": 30,
"type": "integer",
"description": "How many posts are processed in parallel. Lower this if you hit rate limits.",
"default": 8
},
"maxRequestRetries": {
"title": "Max request retries",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "How many times a failed request is retried before the item is given up on.",
"default": 4
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Residential proxies are strongly recommended and used by default. Facebook blocks datacenter IPs aggressively.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}