# 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:** 1,169 total users, 155 monthly users, 100.0% runs succeeded, 17 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — 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 Download the OpenAPI definition: https://api.apify.com/v2/acts/zanTWNqB3Poz44qdY/builds/sdQvexclrR7VvyF3Q/openapi.json