# Facebook Scraper Pro (`alien_force/facebook-scraper-pro`) Actor Facebook Scraper Pro is a powerful Apify actor for extracting Facebook data. It includes: Search Scraper (finds posts by keyword), Profiles Scraper (scrapes profile info & posts), Posts Scraper (extracts posts by URL), and Comments Scraper (collects comments from posts). 🚀 - **URL**: https://apify.com/alien\_force/facebook-scraper-pro.md - **Developed by:** [Alien Force](https://apify.com/alien_force) (community) - **Categories:** Social media, Videos - **Stats:** 750 total users, 50 monthly users, 100.0% runs succeeded, 25 bookmarks - **User rating**: 2.29 out of 5 stars ## Pricing from $7.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Scraper Pro Facebook Scraper Pro is a powerful Apify actor designed to extract data from Facebook efficiently. It offers multiple scraping functions to gather data from Facebook searches, profiles, posts, and comments. Below is a detailed guide to help you understand and use this actor effectively. ### Key Features 1. **Facebook Search Scraper**: Searches for specific keywords on Facebook and returns relevant posts. 2. **Facebook Profiles Scraper**: Extracts detailed information from Facebook profiles, including ID, name, friends count, likes count, location, gender, profile avatar, birthday, and profile posts. 3. **Facebook Posts Scraper**: Scrapes data from specific Facebook posts, including text, likes, comments, shares, and media. 4. **Facebook Comments Scraper**: Extracts comments from specific Facebook posts, including comment text, likes, replies, and author details. ### Important Notes - **Actor Function**: Specifies the scraping function to use (facebook_search_scraper, facebook_profiles_scraper, facebook_posts_scraper, facebook_comments_scraper). - **Rate Limiting**: Use appropriate `min_wait_time_in_sec` and `max_wait_time_in_sec` to avoid blocking. - **Data Limits**: Use the `results_limit` parameter to control the amount of data scraped. ### Input Schema The input schema for the Facebook Scraper Pro actor is as follows: ```json { // enum for "function" ["facebook_search_scraper", "facebook_profiles_scraper", "facebook_posts_scraper", "facebook_comments_scraper"] "function": "facebook_search_scraper", "filter_by_recent_posts": true, // used in facebook_search_scraper "since": "1d", // used to fetch data in interval time (1d, 7d, 30d) "keyword": "BBC", // used in facebook_search_scraper "results_limit": 5, // limit number of posts or comments returned "min_wait_time_in_sec": 2, // minimum seconds to wait for each cursor. "max_wait_time_in_sec": 6, // maximum seconds to wait for each cursor. "cookies": [], // Optional Facebook user account cookies for improved scraping reliability and maintainability. "fetch_reaction_map": false, // When enabled, fetches reaction breakdown for video posts only. "profile_urls": [ // used in facebook_profiles_scraper { "url": "https://www.facebook.com/profile.php?id=61568555420777" } ], "post_urls": [ // used in facebook_posts_scraper { "url": "https://www.facebook.com/watch/?v=918725866988227" } ], "post_urls_for_comments": [ // used in facebook_comments_scraper { "url": "https://www.facebook.com/watch/?v=918725866988227" } ], "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Schema #### Facebook Search Scraper, Facebook Profiles Scraper, Facebook Posts Scraper ```json { // "author" only exists in Facebook Profile Scraper Responses "author": { "user_name": "Chief&Chill", "user_id": "61568555420777", "user_url": "https://www.facebook.com/profile.php?id=61568555420777", "avatar": "https://scontent.fcai20-6.fna.fbcdn.net/v/t39.30808-1/326769796_731573711877409_5775268283301149505_n.jpg?stp=dst-jpg_s200x200_tt6&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=XXAYvfYQ_XgQ7kNvwFiOR3P&_nc_oc=AdneB4lCDPZ95GwkBc18yPBqBDx0KJBbBs3BtpBIarAhHXX_Xe04Bt93nF8-rPbu4mQ&_nc_zt=24&_nc_ht=scontent.fcai20-6.fna&_nc_gid=82BoXRmuCctRCyAwsu2f_w&oh=00_AfJG6Qx8GljgLqvbHK-0LgEBFqp11KvgYfhKtCPYQ84lDw&oe=682E9F53", "intro": "Organizing the world's information and making it universally accessible and useful.", "email": "for.loop.2020@gmail.com", "followers_count": "37K", "friends_count": null, "likes_count": "750", "following_count": null, "location": null, "gender": "UNKNOWN", "birthday": null, "created_at": "22 June 2020", "category": "Community" }, "post_id": "122118274184618514", "action_id": "ZmVlZGJhY2s6MTIyMTE4Mjc0MTg0NjE4NTE0", "text": "No Man Sky !!\nCredits @qballgamingYT\n#gamingcommunity\n#gaming\n#besttime\n#funnymoments", "create_time": 1737231816, "post_url": "https://www.facebook.com/61568555420777/videos/8940928369328022/", "like_count": 47, "comment_count": 0, "share_count": 0, "view_count": 0, "reaction_map": [ { "name": "Like", "count": 3, "parsed_count": "3" } ], "play_count": 0, "image_list": [ "https://scontent.fcai20-3.fna.fbcdn.net/v/t39.30808-6/..." ], "video_list": [], "video_cover_image": [ "https://scontent.fcai20-2.fna.fbcdn.net/v/t15.5256-10/..." ], "durationInSec": [19.966], "type": "video", "author_username": "Nabila", "author_user_id": "61552615223744", "author_profile_url": "https://www.facebook.com/Moviesbaki", "author_avatar": "https://scontent.fcai20-3.fna.fbcdn.net/v/t39.30808-1/...", "comments": [] } ``` **Note:** The `reaction_map` field contains reaction breakdown data when `fetch_reaction_map` is enabled. It is an array of objects with `name`, `count`, and `parsed_count` properties. Example: ```json { "reaction_map": [ { "name": "Like", "count": 166, "parsed_count": "166" }, { "name": "Love", "count": 19, "parsed_count": "19" }, { "name": "Haha", "count": 5, "parsed_count": "5" } ] } ``` #### Facebook Comments Scraper ```json { "action_id": "ZmVlZGJhY2s6OTAyOTM5NjE2MzgxODE1N185MDI5NDA2MTUzODE3MTU4", "comment_id": "9029406153817158", "gender": "FEMALE", "author_user_id": "100009355176494", "author_username": "Lillian Mamdouh", "author_profile_url": "https://www.facebook.com/lillian.mamdouh.7", "author_avatar": "", "text": "Up", "like_count": 0, "reply_count": 0, "create_time": 1738101623, "image_list": [], "video_list": [], "video_cover_image": [], "post": { "post_id": "9029396163818157", "post_url": "https://www.facebook.com/groups/5958702877554183/posts/9029396163818157/", "author_user_id": "pfbid036cJegrwq7rXF3Le6BCGDZd8nwuGw31mwx2smn8go2sbjRe23PocViB4H7DW4VgQ6l", "author_username": "Perihan Sameh", "author_profile_url": null, "author_avatar": "" }, "input": "https://www.facebook.com/groups/5958702877554183/posts/9029396163818157/" } ``` # Actor input Schema ## `cookies` (type: `array`): 1. Install the Cookie-Editor Chrome extension. 2. Log in to your Facebook account. 3. Open the Cookie-Editor extension and export cookies as JSON for facebook.com. 4. Paste the exported cookie contents here. ## `function` (type: `string`): Select what function to work with this actor. ## `facebook_search_scraper_section` (type: `object`): No description ## `keyword` (type: `string`): Provide a keyword to search in Facebook posts. ## `filter_by_recent_posts` (type: `boolean`): When selected, newer posts will be fetched first. ## `since` (type: `string`): Filter by time interval. only works with `facebook_search_scraper` and will override the `filter_by_recent_posts` filter ## `facebook_profiles_scraper_section` (type: `object`): No description ## `profile_urls` (type: `array`): Add Facebook profile urls to scrape posts ## `facebook_posts_scraper` (type: `object`): No description ## `post_urls` (type: `array`): Add Facebook post urls to scrape posts ## `facebook_comments_scraper` (type: `object`): No description ## `post_urls_for_comments` (type: `array`): Add Facebook post urls to scrape posts comments ## `extra` (type: `object`): No description ## `fetch_reaction_map` (type: `boolean`): When turned on, reaction map is fetched for each post of type `video` only. Regular post items are always fetched regardless of this setting. ## `options` (type: `object`): No description ## `results_limit` (type: `integer`): Limit number of results, minimum is 10 results ## `min_wait_time_in_sec` (type: `integer`): Minimum seconds to wait for each cursor. ## `max_wait_time_in_sec` (type: `integer`): Maximum seconds to wait for each cursor. ## `proxy_configuration_section` (type: `object`): No description ## `proxyConfiguration` (type: `object`): Configure proxies to be used by the crawler. ## Actor input object example ```json { "cookies": [], "function": "facebook_search_scraper", "keyword": "BBC", "filter_by_recent_posts": false, "since": "all_times", "profile_urls": [], "post_urls": [], "post_urls_for_comments": [], "fetch_reaction_map": false, "results_limit": 10, "min_wait_time_in_sec": 1, "max_wait_time_in_sec": 4, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "cookies": [], "function": "facebook_search_scraper", "keyword": "BBC", "filter_by_recent_posts": false, "fetch_reaction_map": false, "results_limit": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("alien_force/facebook-scraper-pro").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 = { "cookies": [], "function": "facebook_search_scraper", "keyword": "BBC", "filter_by_recent_posts": False, "fetch_reaction_map": False, "results_limit": 10, } # Run the Actor and wait for it to finish run = client.actor("alien_force/facebook-scraper-pro").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 '{ "cookies": [], "function": "facebook_search_scraper", "keyword": "BBC", "filter_by_recent_posts": false, "fetch_reaction_map": false, "results_limit": 10 }' | apify call alien_force/facebook-scraper-pro --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=alien_force/facebook-scraper-pro", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Scraper Pro", "description": "Facebook Scraper Pro is a powerful Apify actor for extracting Facebook data. It includes: Search Scraper (finds posts by keyword), Profiles Scraper (scrapes profile info & posts), Posts Scraper (extracts posts by URL), and Comments Scraper (collects comments from posts). 🚀", "version": "0.3", "x-build-id": "RV6avkUDpePaHufZg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/alien_force~facebook-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-alien_force-facebook-scraper-pro", "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/alien_force~facebook-scraper-pro/runs": { "post": { "operationId": "runs-sync-alien_force-facebook-scraper-pro", "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/alien_force~facebook-scraper-pro/run-sync": { "post": { "operationId": "run-sync-alien_force-facebook-scraper-pro", "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": [ "function" ], "properties": { "cookies": { "title": "Cookies", "type": "array", "description": "1. Install the Cookie-Editor Chrome extension.\n2. Log in to your Facebook account.\n3. Open the Cookie-Editor extension and export cookies as JSON for facebook.com.\n4. Paste the exported cookie contents here.", "default": [] }, "function": { "title": "Select what function to work with", "enum": [ "facebook_search_scraper", "facebook_profiles_scraper", "facebook_posts_scraper", "facebook_comments_scraper" ], "type": "string", "description": "Select what function to work with this actor." }, "facebook_search_scraper_section": { "title": "", "type": "object", "description": "" }, "keyword": { "title": "Keyword", "type": "string", "description": "Provide a keyword to search in Facebook posts." }, "filter_by_recent_posts": { "title": "Filter By Recent", "type": "boolean", "description": "When selected, newer posts will be fetched first.", "default": false }, "since": { "title": "Fetch Posts in Time Interval", "enum": [ "all_times", "1d", "7d", "30d" ], "type": "string", "description": "Filter by time interval. only works with `facebook_search_scraper` and will override the `filter_by_recent_posts` filter", "default": "all_times" }, "facebook_profiles_scraper_section": { "title": "", "type": "object", "description": "" }, "profile_urls": { "title": "Profile Urls", "type": "array", "description": "Add Facebook profile urls to scrape posts", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "facebook_posts_scraper": { "title": "", "type": "object", "description": "" }, "post_urls": { "title": "Post Urls", "type": "array", "description": "Add Facebook post urls to scrape posts", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "facebook_comments_scraper": { "title": "", "type": "object", "description": "" }, "post_urls_for_comments": { "title": "Post Urls For Comments", "type": "array", "description": "Add Facebook post urls to scrape posts comments", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "extra": { "title": "", "type": "object", "description": "" }, "fetch_reaction_map": { "title": "Fetch Reaction Map", "type": "boolean", "description": "When turned on, reaction map is fetched for each post of type `video` only. Regular post items are always fetched regardless of this setting.", "default": false }, "options": { "title": "", "type": "object", "description": "" }, "results_limit": { "title": "Results Limit", "type": "integer", "description": "Limit number of results, minimum is 10 results", "default": 10 }, "min_wait_time_in_sec": { "title": "Minimum Seconds Awaited", "minimum": 0, "maximum": 2, "type": "integer", "description": "Minimum seconds to wait for each cursor.", "default": 1 }, "max_wait_time_in_sec": { "title": "Maximum Seconds Awaited", "minimum": 3, "maximum": 6, "type": "integer", "description": "Maximum seconds to wait for each cursor.", "default": 4 }, "proxy_configuration_section": { "title": "", "type": "object", "description": "" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Configure proxies to be used by the crawler.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```