# Facebook Posts Scraper (`scraper_one/facebook-posts-scraper`) Actor Scrape Facebook posts from Facebook pages, groups etc. Retrieve post URLs, content, publication dates, author details, and engagement metrics. Ideal for Facebook monitoring solutions. - **URL**: https://apify.com/scraper\_one/facebook-posts-scraper.md - **Developed by:** [Scraper One](https://apify.com/scraper_one) (community) - **Categories:** Automation, Developer tools, Lead generation - **Stats:** 800 total users, 95 monthly users, 100.0% runs succeeded, 16 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Posts Scraper ![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue) This apify actor **scrapes public posts from Facebook** groups or pages based on input URLs. It supports **pagination and returns data including post content, timestamp, number of comments, reactions, and author information**. Ideal for **social media monitoring** solutions. ### Input The actor accepts the following input fields: | Field | Type | Required | Description | |----------------|------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `pageUrls` | `string[]` | βœ… | A list of Facebook group or page URLs to scrape posts from. | | `resultsLimit` | `number` | ❌ | Maximum number of posts to extract from each URL (default: 10). | #### Example input ```json { "resultsLimit": 3, "pageUrls": [ "https://www.facebook.com/groups/1054903574928547", "https://www.facebook.com/tweakedmotorsports", "https://www.facebook.com/groups/289835267786139" ] } ```` ### Output The actor outputs an array of post objects in JSON format with the following fields: #### Example output ```json { "url": "https://www.facebook.com/groups/1054903574928547/permalink/2303563860062506/", "pageUrl": "https://www.facebook.com/groups/1054903574928547", "timestamp": 1752519380000, "postText": "Hey, how can I save my geranium? I repotted it and now it’s wilting before my eyes. πŸ˜”", "reactionsCount": 3, "reactions": { "like": 3, "love": 10, "sad": 15, "angry": 4, "haha": 1 }, "commentsCount": 20, "postId": "2303563860062506", "author": { "id": "100055230212550", "name": "Yyyyy Tttttt", "profilePicture": "https://scontent-mad2-1.xx.fbcdn.net/v/t39.30808-1/274300141_461291382388532_2921259538884887660_n.jpg?...", "profileUrl": "https://www.facebook.com/kttata.adasda.44" } } ``` ###### Let me know if you need additional output fields! πŸ€™ ### Usage 1. **Create an Apify account** and navigate to the actor. 2. **Configure input parameters** in the Apify UI or via API. 3. **Run the actor** and monitor execution logs. 4. **Download extracted comments** as JSON, CSV, or Excel. ### Limitations & Notes - Scraping Facebook data **must comply with their Terms of Service**. - Avoid excessive scraping to prevent IP bans. - The accuracy of data depends on Facebook’s page structure and visibility settings. - Rate-limited – Free users can make only a few requests per day. **Contact us if you need higher or custom limits!** *** ### Works Best With For the best results, use this scraper alongside [Facebook Comments Scraper](https://apify.com/scraper_one/facebook-comments-scraper). Before extracting comments, you can use the Facebook Posts Scraper actor to gather post URLs from specified pages. Then, pass those URLs into Facebook Comments Scraper to collect comments associated with those posts. βœ… Best Use Case Scenario - Run Facebook Posts Scraper β†’ Collect posts from facebook pages. - Feed post URLs into Facebook Comments Scraper β†’ Extract comments for each post. - Gain complete insights β†’ Combine posts and comments for a full dataset, useful for engagement analysis, sentiment tracking, and social media monitoring. This combination provides a powerful way to analyze conversations happening around specific posts! πŸš€ ### Other Recommended Scrapers If you're working with multiple platforms or want additional data sources, check out these scrapers: - 🐦 [X (Twitter) Posts Search](https://apify.com/scraper_one/x-posts-search) β€” Find posts/tweets based on keywords, hashtags, and more - 🐦 [X (Twitter) Post Replies Scraper](https://apify.com/scraper_one/x-post-replies-scraper) β€” Scrap replies of multiple X (Twitter) posts - 🐦 [X (Twitter) Profile Posts Scraper](https://apify.com/scraper_one/x-profile-posts-scraper) β€” Scrap posts of specific X (Twitter) profile - πŸ“˜ [Facebook Posts Search](https://apify.com/scraper_one/facebook-posts-search) β€” Discover Facebook posts for a given topic or page - πŸ“˜ [Facebook Comments Scraper](https://apify.com/scraper_one/facebook-comments-scraper) β€” Extract comments from public Facebook posts - πŸ“˜ [Facebook Reactions Scraper](https://apify.com/scraper_one/facebook-reactions-scraper) β€” Scrap reactions from Facebook posts (like, sad, haha, angry etc.) - πŸ“˜ [Facebook Posts Scraper](https://apify.com/scraper_one/facebook-posts-scraper) β€” Scrap posts from Facebook pages, groups etc. - 🎬 [YouTube Search Scraper](https://apify.com/scraper_one/youtube-search-scraper) β€” Extract videos from search queries - 🎬 [YouTube Comments Scraper](https://apify.com/scraper_one/youtube-comments-scraper) β€” Extract comments from posted videos - 🎬 [YouTube Downloader](https://apify.com/scraper_one/yt-downloader) β€” Download youtube videos ### Support & Contact βœ‰οΈ If you encounter issues or need help, feel free to **open an issue** or contact us at **scraper1one@gmail.com**. # Actor input Schema ## `pageUrls` (type: `array`): List of page URLs to process ## `resultsLimit` (type: `integer`): Maximum number of posts to retrieve per page (between 1 and 100). If not set, only a few of the first posts will be returned. ## Actor input object example ```json { "pageUrls": [ "https://www.facebook.com/NFL", "https://www.facebook.com/oldmillartsOMA" ], "resultsLimit": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "pageUrls": [ "https://www.facebook.com/NFL", "https://www.facebook.com/oldmillartsOMA" ], "resultsLimit": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("scraper_one/facebook-posts-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 = { "pageUrls": [ "https://www.facebook.com/NFL", "https://www.facebook.com/oldmillartsOMA", ], "resultsLimit": 10, } # Run the Actor and wait for it to finish run = client.actor("scraper_one/facebook-posts-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 '{ "pageUrls": [ "https://www.facebook.com/NFL", "https://www.facebook.com/oldmillartsOMA" ], "resultsLimit": 10 }' | apify call scraper_one/facebook-posts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraper_one/facebook-posts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Posts Scraper", "description": "Scrape Facebook posts from Facebook pages, groups etc. Retrieve post URLs, content, publication dates, author details, and engagement metrics. Ideal for Facebook monitoring solutions.", "version": "0.0", "x-build-id": "bRNcg6RMHsH4upq39" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraper_one~facebook-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraper_one-facebook-posts-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/scraper_one~facebook-posts-scraper/runs": { "post": { "operationId": "runs-sync-scraper_one-facebook-posts-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/scraper_one~facebook-posts-scraper/run-sync": { "post": { "operationId": "run-sync-scraper_one-facebook-posts-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": [ "pageUrls" ], "properties": { "pageUrls": { "title": "Page URLs", "maxItems": 5, "type": "array", "description": "List of page URLs to process", "items": { "type": "string" } }, "resultsLimit": { "title": "Results Limit", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of posts to retrieve per page (between 1 and 100). If not set, only a few of the first posts will be returned.", "default": 10 } } }, "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 } } } } } } } } } } ```