# Facebook Comments Scraper (`leadsbrary/facebook-comments-scraper`) Actor Extract comments from any public Facebook post, reel, or video. Get comment text, date, author name, profile link, reaction count, and reply count. Configure output fields, filter by date, sort results. Export as JSON, CSV, or Excel. - **URL**: https://apify.com/leadsbrary/facebook-comments-scraper.md - **Developed by:** [Alexandre Manguis](https://apify.com/leadsbrary) (community) - **Categories:** Social media, Integrations - **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.20 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Facebook Comments Scraper Extract comments from any public Facebook post, reel, or video — no account required. Returns commenter name, profile link, comment text, date, reaction count, and reply count. Supports pagination, date filtering, sort order, and fully configurable output fields. --- ### What it does Provide one or more public Facebook post URLs. The scraper will retrieve all comments, paginate automatically until the requested limit is reached, and return structured data for each comment. Works on posts, reels, videos, and photo posts from public pages and profiles. --- ### Output fields All fields are optional and can be enabled or disabled individually in the input. | Field | Always included | Description | |---|---|---| | `text` | ✅ | Full comment text | | `id` | ✅ | Unique comment identifier | | `feedbackId` | ✅ | Internal feedback object ID | | `comments` | ✅ | Nested replies (when enabled) | | `date` | optional | ISO 8601 timestamp | | `profileName` | optional | Commenter's display name | | `profileUrl` | optional | Link to commenter's profile | | `likesCount` | optional | Total reactions on the comment | | `commentsCount` | optional | Number of replies | | `commentUrl` | optional | Direct link to the comment | | `facebookUrl` | optional | Canonical post URL | | `postTitle` | optional | Post title or text excerpt | | `inputUrl` | optional | The URL you provided as input | | `facebookId` | optional | Numeric post ID | > `likesCount` is the total of all reaction types (Like, Love, Haha, Wow, Sad, Angry) combined. --- ### Input #### Required | Field | Description | |---|---| | `startUrls` | One or more public Facebook post, reel, or video URLs | #### Optional | Field | Default | Description | |---|---|---| | `resultsLimit` | `100` | Max comments to extract per URL | | `viewOption` | `RANKED_UNFILTERED` | Sort order (see below) | | `includeNestedComments` | `false` | Also extract replies to top-level comments | | `onlyCommentsNewerThan` | — | Date filter (see below) | #### Sort order | Value | Description | |---|---| | `RANKED_UNFILTERED` | Most relevant — Facebook's default | | `RANKED_THREADED` | Top comments grouped with their replies | | `RECENT_ACTIVITY` | Most recently active threads first | #### Date filter `onlyCommentsNewerThan` accepts: - Relative: `1 day`, `2 weeks`, `3 months`, `1 year` - Absolute: `2024-01-01` or `2024-06-15T12:00:00Z` Use `RECENT_ACTIVITY` sort when filtering by date. #### Output fields (checkboxes) Each output field can be toggled individually. All are enabled by default: - **Date** — comment timestamp - **Author name** — commenter's display name - **Author profile URL** — link to commenter's profile - **Likes / reactions** — total reaction count - **Reply count** — number of replies - **Post URL & title** — post context columns - **Comment URL** — direct link to the comment - **Post ID** — numeric Facebook post ID --- ### Example input ```json { "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" } ], "resultsLimit": 200, "viewOption": "RANKED_UNFILTERED", "includeNestedComments": false } ```` ### Example output ```json { "text": "This is one of my favorite stories to date.", "date": "2021-08-15T20:01:24.000Z", "profileName": "Judie Wilson", "profileUrl": "https://www.facebook.com/profile.php?id=100004...", "likesCount": "443", "commentsCount": 8, "comments": [], "commentUrl": "https://www.facebook.com/humansofnewyork/posts/pfbid0B...?comment_id=481627996424606", "facebookId": "6375219342552112", "postTitle": "Humans of New York", "facebookUrl": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbK...", "inputUrl": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbK...", "id": "Y29tbWVudDo2Mzc...", "feedbackId": "ZmVlZGJhY2s6..." } ``` *** ### Supported URL formats ``` https://www.facebook.com/{page}/posts/{post_id} https://www.facebook.com/{page}/posts/{pfbid} https://www.facebook.com/reel/{reel_id} https://www.facebook.com/{page}/videos/{video_id} https://www.facebook.com/photo?fbid={photo_id} https://www.facebook.com/permalink/story.php?story_fbid={id}&id={page_id} ``` *** ### Limits and notes - **Public posts only.** Private posts and posts requiring login are skipped. - **No login required.** Works entirely with public data. - For large comment sections (10 000+), use date filters to narrow scope. *** ### Keywords facebook comments scraper, facebook post comments, extract facebook comments, facebook comment extractor, scrape facebook comments, facebook comments api, facebook data extraction, facebook social media scraper, public facebook posts, facebook comment text, facebook commenter name, facebook commenter profile, facebook reactions count, facebook replies scraper, facebook post analysis, social media monitoring facebook, facebook audience insights, facebook engagement scraper, comment sentiment analysis, facebook marketing data, facebook page comments, facebook content scraper, facebook public data, facebook comment downloader, facebook post scraper # Actor input Schema ## `startUrls` (type: `array`): List of public Facebook post, reel, or video URLs to scrape comments from. Supported formats: - `https://www.facebook.com/{page}/posts/{post_id}` - `https://www.facebook.com/reel/{reel_id}` - `https://www.facebook.com/{page}/videos/{video_id}` - `https://www.facebook.com/photo?fbid={photo_id}` ## `resultsLimit` (type: `integer`): Maximum number of top-level comments (and replies if enabled) to extract per post URL. ## `viewOption` (type: `string`): How to sort the returned comments. ## `includeNestedComments` (type: `boolean`): When enabled, also extract replies to top-level comments (up to 2 levels deep). Increases the total number of items returned. ## `onlyCommentsNewerThan` (type: `string`): Filter out older comments. Supports: - Absolute dates: `2024-01-01` or `2024-06-15T12:00:00Z` - Relative values: `1 day`, `2 weeks`, `3 months`, `1 year` When set, sorting is automatically switched to **Newest first** so the filter works correctly. ## `includeDate` (type: `boolean`): Include the comment timestamp in the output. ## `includeAuthor` (type: `boolean`): Include the commenter's display name. ## `includeProfileUrl` (type: `boolean`): Include a link to the commenter's Facebook profile. ## `includeLikes` (type: `boolean`): Include the total reaction count on the comment. ## `includeReplies` (type: `boolean`): Include the number of replies to the comment. ## `includePostUrl` (type: `boolean`): Include the post URL and title in each comment row. ## `includeCommentUrl` (type: `boolean`): Include a direct link to the comment. ## `includePostId` (type: `boolean`): Include the numeric Facebook post ID. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" } ], "resultsLimit": 100, "viewOption": "RANKED_UNFILTERED", "includeNestedComments": false, "includeDate": true, "includeAuthor": true, "includeProfileUrl": true, "includeLikes": true, "includeReplies": true, "includePostUrl": true, "includeCommentUrl": true, "includePostId": true } ``` # Actor output Schema ## `results` (type: `string`): Dataset containing all extracted comments (text, author, date, reactions, replies…). # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("leadsbrary/facebook-comments-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" }] } # Run the Actor and wait for it to finish run = client.actor("leadsbrary/facebook-comments-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.facebook.com/humansofnewyork/posts/pfbid0BbKbkisExKGSKuhee9a7i86RwRuMKFC8NSkKStB7CsM3uXJuAAfZLrkcJMXxhH4Yl" } ] }' | apify call leadsbrary/facebook-comments-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=leadsbrary/facebook-comments-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Comments Scraper", "description": "Extract comments from any public Facebook post, reel, or video. Get comment text, date, author name, profile link, reaction count, and reply count. Configure output fields, filter by date, sort results. Export as JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "WcDcfVfI6dQ9VdUYy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/leadsbrary~facebook-comments-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-leadsbrary-facebook-comments-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/leadsbrary~facebook-comments-scraper/runs": { "post": { "operationId": "runs-sync-leadsbrary-facebook-comments-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/leadsbrary~facebook-comments-scraper/run-sync": { "post": { "operationId": "run-sync-leadsbrary-facebook-comments-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": "Post URLs", "type": "array", "description": "List of public Facebook post, reel, or video URLs to scrape comments from.\n\nSupported formats:\n- `https://www.facebook.com/{page}/posts/{post_id}`\n- `https://www.facebook.com/reel/{reel_id}`\n- `https://www.facebook.com/{page}/videos/{video_id}`\n- `https://www.facebook.com/photo?fbid={photo_id}`", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "resultsLimit": { "title": "Max comments per post", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of top-level comments (and replies if enabled) to extract per post URL.", "default": 100 }, "viewOption": { "title": "Sort order", "enum": [ "RANKED_UNFILTERED", "RANKED_THREADED", "RECENT_ACTIVITY" ], "type": "string", "description": "How to sort the returned comments.", "default": "RANKED_UNFILTERED" }, "includeNestedComments": { "title": "Include replies (nested comments)", "type": "boolean", "description": "When enabled, also extract replies to top-level comments (up to 2 levels deep). Increases the total number of items returned.", "default": false }, "onlyCommentsNewerThan": { "title": "Only comments newer than", "type": "string", "description": "Filter out older comments. Supports:\n- Absolute dates: `2024-01-01` or `2024-06-15T12:00:00Z`\n- Relative values: `1 day`, `2 weeks`, `3 months`, `1 year`\n\nWhen set, sorting is automatically switched to **Newest first** so the filter works correctly." }, "includeDate": { "title": "Date", "type": "boolean", "description": "Include the comment timestamp in the output.", "default": true }, "includeAuthor": { "title": "Author name", "type": "boolean", "description": "Include the commenter's display name.", "default": true }, "includeProfileUrl": { "title": "Author profile URL", "type": "boolean", "description": "Include a link to the commenter's Facebook profile.", "default": true }, "includeLikes": { "title": "Likes / reactions", "type": "boolean", "description": "Include the total reaction count on the comment.", "default": true }, "includeReplies": { "title": "Reply count", "type": "boolean", "description": "Include the number of replies to the comment.", "default": true }, "includePostUrl": { "title": "Post URL & title", "type": "boolean", "description": "Include the post URL and title in each comment row.", "default": true }, "includeCommentUrl": { "title": "Comment URL", "type": "boolean", "description": "Include a direct link to the comment.", "default": true }, "includePostId": { "title": "Post ID", "type": "boolean", "description": "Include the numeric Facebook post ID.", "default": true } } }, "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 } } } } } } } } } } ```