# Facebook Pages Scraper (`parseforge/facebook-pages-scraper`) Actor Scrapes public Facebook page profile data from a list of URLs or slugs. Returns each page's name, category, follower count, and verification status as a flat row. - **URL**: https://apify.com/parseforge/facebook-pages-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 73 total users, 8 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $12.99 / 1,000 result items 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/actors/running/actors-in-store.md#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 [![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp) ### Facebook Pages Scraper **Scrape public Facebook page data including follower counts, page categories, and verification status, up to thousands of pages per run.** Each page returns its name, likes, check-ins, and full about details. No login or API key required. Export to CSV, JSON, Excel, or XML. Facebook's official Graph API requires a business verification, app review, and strict rate limits that throttle large-scale data collection. This actor reads the public page information directly, collecting profile details, follower metrics, and business categories from any list of page URLs or slugs. It returns each page in one consistent schema, ready for analysis or enrichment pipelines. | Who uses it | What they scrape Facebook for | |---|---| | Market researchers | Benchmarking competitor brand presence and audience size across industries. | | Lead generation teams | Building a list of verified business pages with contact categories for outreach. | | Data journalists | Auditing the follower counts and verification badges of public figures or organizations. | | Brand managers | Monitoring the basic profile health and category placement of owned regional pages. | ### What it does This Actor collects public Facebook page profile data from direct URLs or page slugs and returns each page as a flat row with its name, category, follower count, and verification status. - 🔗 **Flexible input:** Feed the actor a list of full Facebook page URLs, short page slugs, or mix both in a single run. - ⚙️ **Configurable speed:** Set the maximum concurrency to balance speed against rate limiting, from a cautious single request up to 20 parallel fetches. - 📋 **Structured output:** Every page lands as a clean row with the same columns, regardless of how much or how little detail its public profile shows. Results export to CSV, JSON, Excel, or XML, or straight from the API. ### What you can do with Facebook data **📊 Audit a competitor brand list.** A market analyst uploads 500 competitor page URLs to compare follower counts, page categories, and verification status across the sector. **🗺️ Enrich a CRM with page metadata.** A sales team matches company names to Facebook slugs, then scrapes the latest follower numbers and categories to prioritize high-reach accounts. **🔍 Verify a list of public figure pages.** A researcher checks a list of politician or celebrity slugs to confirm which pages carry a verified badge and their current follower reach. **🏢 Audit regional brand pages.** A global brand manager scrapes all local market pages to ensure each one has the correct category, name format, and is still actively maintained. ### Why choose this scraper | | What you get | |---|---| | **No API approvals** | Bypass the Graph API review process and collect public page data immediately. | | **Batch processing** | Scrape thousands of pages in one run by pasting a list of URLs or slugs. | | **Fixed schema** | Get the same fields for every page, making it simple to merge with existing datasets. | ### How it compares This actor focuses on scraping the public profile metadata of Facebook pages, while the Facebook Posts Scraper is built to extract the timeline content and engagement metrics from those pages. | Feature | ParseForge | Facebook Posts Scraper | |---|---|---| | Page profile metadata | Yes | Not listed | | Follower count and check-ins | Yes | Not listed | | Page category and verification status | Yes | Not listed | | Input by page slug | Yes | Not listed | | Timeline posts and captions | Not listed | Yes | | Post reactions and comments | Not listed | Yes | ### Configure the run Drive the Actor from a list of Facebook page URLs or page slugs, and it collects the public profile data for each one in parallel. The Input tab lists every parameter. A first run with the defaults: ```json { "startUrls": [ { "url": "https://www.facebook.com/mcdonalds/" }, { "url": "https://www.facebook.com/cocacola/" }, { "url": "https://www.facebook.com/nike/" }, { "url": "https://www.facebook.com/adidas/" }, { "url": "https://www.facebook.com/apple/" }, { "url": "https://www.facebook.com/google/" }, { "url": "https://www.facebook.com/microsoft/" }, { "url": "https://www.facebook.com/samsung/" }, { "url": "https://www.facebook.com/starbucks/" }, { "url": "https://www.facebook.com/amazon/" }, { "url": "https://www.facebook.com/netflix/" }, { "url": "https://www.facebook.com/tesla/" }, { "url": "https://www.facebook.com/spotify/" }, { "url": "https://www.facebook.com/airbnb/" }, { "url": "https://www.facebook.com/uber/" }, { "url": "https://www.facebook.com/lyft/" }, { "url": "https://www.facebook.com/walmart/" }, { "url": "https://www.facebook.com/target/" }, { "url": "https://www.facebook.com/bestbuy/" }, { "url": "https://www.facebook.com/costco/" }, { "url": "https://www.facebook.com/homedepot/" }, { "url": "https://www.facebook.com/lowes/" }, { "url": "https://www.facebook.com/fedex/" }, { "url": "https://www.facebook.com/ups/" }, { "url": "https://www.facebook.com/dhl/" }, { "url": "https://www.facebook.com/visa/" }, { "url": "https://www.facebook.com/mastercard/" }, { "url": "https://www.facebook.com/paypal/" }, { "url": "https://www.facebook.com/americanexpress/" }, { "url": "https://www.facebook.com/chase/" }, { "url": "https://www.facebook.com/bankofamerica/" }, { "url": "https://www.facebook.com/wellsfargo/" }, { "url": "https://www.facebook.com/citi/" }, { "url": "https://www.facebook.com/sony/" }, { "url": "https://www.facebook.com/disney/" }, { "url": "https://www.facebook.com/marvel/" }, { "url": "https://www.facebook.com/lego/" }, { "url": "https://www.facebook.com/playstation/" }, { "url": "https://www.facebook.com/xboxone/" }, { "url": "https://www.facebook.com/ebay/" } ] } ``` ### Pricing Pay-per-result: **$0.01734 per result** collected. You pay only for the results written to your dataset. | Results collected | Approximate cost | |---|---| | 100 results | $1.73 | | 1,000 results | $17.34 | | 10,000 results | $173.40 | New Apify accounts start with $5 in free credit. ### Free users Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run. ### Run it 1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp). 2. Open the [Facebook Pages Scraper](https://apify.com/parseforge/facebook-pages-scraper?fpr=vmoqkp). 3. Set your inputs and any filters, then click **Start**. 4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab. Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python. ### Use with AI agents (MCP) Give an AI agent live access to Facebook through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client: ```bash claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/facebook-pages-scraper" ``` Then prompt it in plain language to run the scraper and read back the results. ### Troubleshooting **Why am I getting empty results for some URLs?** The page might be private, deleted, or the URL might be malformed. Double-check that the URL points to a live, public Facebook page and that the slug is spelled correctly. **The actor is running very slowly or getting stuck.** Facebook may be throttling your requests. Reduce the max concurrency to 1 or 2, and ensure you are using a reliable proxy configuration to distribute the requests. **I received a 'rate limited' or access denied error.** Lower your concurrency setting and consider adding a longer delay between runs. Using Apify's residential proxies can also help avoid aggressive rate limiting from Facebook. **The data shows zero followers for a page I know has followers.** Some pages hide their follower count or display it only after interaction. The actor can only capture the number that is publicly visible in the page's HTML on first load. ### FAQ | Question | Answer | |---|---| | Can this scrape private Facebook profiles or groups? | No. This actor only collects data from public Facebook pages. It cannot access private profiles, closed groups, or any content that requires a login to view. | | Do I need a Facebook account or API key to use this? | No. The actor reads the public-facing version of each page, so you do not need to log in, register an app, or obtain an API key. | | What is the difference between a page URL and a page slug? | A page URL is the full link like https://www.facebook.com/nike. A page slug is the short username part, like 'nike'. You can use either format, or mix both in the same run. | | How many pages can I scrape in one run? | There is no hard limit on the number of pages. You can paste thousands of URLs or slugs into the input, and the actor will process them based on your concurrency settings. | | Will I get blocked if I scrape too fast? | Facebook may show rate-limiting checks if you send too many requests at once. Lower the max concurrency setting in the input to slow down the crawl and reduce the chance of being blocked. | | Does this actor extract posts, comments, or reviews? | No. This actor is designed for page profile metadata only. It collects the name, category, follower count, and verification status, not the page's feed or timeline content. | | Can I use this to find the email address or phone number of a page? | It collects whatever contact information is publicly listed in the page's about section. If a page has hidden that detail, it will not appear in the results. | | What format does the data export to? | You can export your results to CSV, JSON, Excel, or XML directly from the Apify dataset tab after the run finishes. | ### Related actors Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers. 🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected. ⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Meta Platforms, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully. # Actor input Schema ## `startUrls` (type: `array`): Direct Facebook page URLs to scrape (e.g. https://www.facebook.com/mcdonalds/). Can be combined with pageSlugs. ## `pageSlugs` (type: `array`): Facebook page slugs/usernames without domain (e.g. mcdonalds). Can be combined with startUrls. ## `maxConcurrency` (type: `integer`): Maximum number of parallel requests. Lower this if you get rate-limited. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.facebook.com/mcdonalds/" }, { "url": "https://www.facebook.com/cocacola/" }, { "url": "https://www.facebook.com/nike/" }, { "url": "https://www.facebook.com/adidas/" }, { "url": "https://www.facebook.com/apple/" }, { "url": "https://www.facebook.com/google/" }, { "url": "https://www.facebook.com/microsoft/" }, { "url": "https://www.facebook.com/samsung/" }, { "url": "https://www.facebook.com/starbucks/" }, { "url": "https://www.facebook.com/amazon/" }, { "url": "https://www.facebook.com/netflix/" }, { "url": "https://www.facebook.com/tesla/" }, { "url": "https://www.facebook.com/spotify/" }, { "url": "https://www.facebook.com/airbnb/" }, { "url": "https://www.facebook.com/uber/" }, { "url": "https://www.facebook.com/lyft/" }, { "url": "https://www.facebook.com/walmart/" }, { "url": "https://www.facebook.com/target/" }, { "url": "https://www.facebook.com/bestbuy/" }, { "url": "https://www.facebook.com/costco/" }, { "url": "https://www.facebook.com/homedepot/" }, { "url": "https://www.facebook.com/lowes/" }, { "url": "https://www.facebook.com/fedex/" }, { "url": "https://www.facebook.com/ups/" }, { "url": "https://www.facebook.com/dhl/" }, { "url": "https://www.facebook.com/visa/" }, { "url": "https://www.facebook.com/mastercard/" }, { "url": "https://www.facebook.com/paypal/" }, { "url": "https://www.facebook.com/americanexpress/" }, { "url": "https://www.facebook.com/chase/" }, { "url": "https://www.facebook.com/bankofamerica/" }, { "url": "https://www.facebook.com/wellsfargo/" }, { "url": "https://www.facebook.com/citi/" }, { "url": "https://www.facebook.com/sony/" }, { "url": "https://www.facebook.com/disney/" }, { "url": "https://www.facebook.com/marvel/" }, { "url": "https://www.facebook.com/lego/" }, { "url": "https://www.facebook.com/playstation/" }, { "url": "https://www.facebook.com/xboxone/" }, { "url": "https://www.facebook.com/ebay/" } ], "maxConcurrency": 3 } ``` # Actor output Schema ## `overview` (type: `string`): Dataset overview table # 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/mcdonalds/" }, { "url": "https://www.facebook.com/cocacola/" }, { "url": "https://www.facebook.com/nike/" }, { "url": "https://www.facebook.com/adidas/" }, { "url": "https://www.facebook.com/apple/" }, { "url": "https://www.facebook.com/google/" }, { "url": "https://www.facebook.com/microsoft/" }, { "url": "https://www.facebook.com/samsung/" }, { "url": "https://www.facebook.com/starbucks/" }, { "url": "https://www.facebook.com/amazon/" }, { "url": "https://www.facebook.com/netflix/" }, { "url": "https://www.facebook.com/tesla/" }, { "url": "https://www.facebook.com/spotify/" }, { "url": "https://www.facebook.com/airbnb/" }, { "url": "https://www.facebook.com/uber/" }, { "url": "https://www.facebook.com/lyft/" }, { "url": "https://www.facebook.com/walmart/" }, { "url": "https://www.facebook.com/target/" }, { "url": "https://www.facebook.com/bestbuy/" }, { "url": "https://www.facebook.com/costco/" }, { "url": "https://www.facebook.com/homedepot/" }, { "url": "https://www.facebook.com/lowes/" }, { "url": "https://www.facebook.com/fedex/" }, { "url": "https://www.facebook.com/ups/" }, { "url": "https://www.facebook.com/dhl/" }, { "url": "https://www.facebook.com/visa/" }, { "url": "https://www.facebook.com/mastercard/" }, { "url": "https://www.facebook.com/paypal/" }, { "url": "https://www.facebook.com/americanexpress/" }, { "url": "https://www.facebook.com/chase/" }, { "url": "https://www.facebook.com/bankofamerica/" }, { "url": "https://www.facebook.com/wellsfargo/" }, { "url": "https://www.facebook.com/citi/" }, { "url": "https://www.facebook.com/sony/" }, { "url": "https://www.facebook.com/disney/" }, { "url": "https://www.facebook.com/marvel/" }, { "url": "https://www.facebook.com/lego/" }, { "url": "https://www.facebook.com/playstation/" }, { "url": "https://www.facebook.com/xboxone/" }, { "url": "https://www.facebook.com/ebay/" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/facebook-pages-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/mcdonalds/" }, { "url": "https://www.facebook.com/cocacola/" }, { "url": "https://www.facebook.com/nike/" }, { "url": "https://www.facebook.com/adidas/" }, { "url": "https://www.facebook.com/apple/" }, { "url": "https://www.facebook.com/google/" }, { "url": "https://www.facebook.com/microsoft/" }, { "url": "https://www.facebook.com/samsung/" }, { "url": "https://www.facebook.com/starbucks/" }, { "url": "https://www.facebook.com/amazon/" }, { "url": "https://www.facebook.com/netflix/" }, { "url": "https://www.facebook.com/tesla/" }, { "url": "https://www.facebook.com/spotify/" }, { "url": "https://www.facebook.com/airbnb/" }, { "url": "https://www.facebook.com/uber/" }, { "url": "https://www.facebook.com/lyft/" }, { "url": "https://www.facebook.com/walmart/" }, { "url": "https://www.facebook.com/target/" }, { "url": "https://www.facebook.com/bestbuy/" }, { "url": "https://www.facebook.com/costco/" }, { "url": "https://www.facebook.com/homedepot/" }, { "url": "https://www.facebook.com/lowes/" }, { "url": "https://www.facebook.com/fedex/" }, { "url": "https://www.facebook.com/ups/" }, { "url": "https://www.facebook.com/dhl/" }, { "url": "https://www.facebook.com/visa/" }, { "url": "https://www.facebook.com/mastercard/" }, { "url": "https://www.facebook.com/paypal/" }, { "url": "https://www.facebook.com/americanexpress/" }, { "url": "https://www.facebook.com/chase/" }, { "url": "https://www.facebook.com/bankofamerica/" }, { "url": "https://www.facebook.com/wellsfargo/" }, { "url": "https://www.facebook.com/citi/" }, { "url": "https://www.facebook.com/sony/" }, { "url": "https://www.facebook.com/disney/" }, { "url": "https://www.facebook.com/marvel/" }, { "url": "https://www.facebook.com/lego/" }, { "url": "https://www.facebook.com/playstation/" }, { "url": "https://www.facebook.com/xboxone/" }, { "url": "https://www.facebook.com/ebay/" }, ] } # Run the Actor and wait for it to finish run = client.actor("parseforge/facebook-pages-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).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/mcdonalds/" }, { "url": "https://www.facebook.com/cocacola/" }, { "url": "https://www.facebook.com/nike/" }, { "url": "https://www.facebook.com/adidas/" }, { "url": "https://www.facebook.com/apple/" }, { "url": "https://www.facebook.com/google/" }, { "url": "https://www.facebook.com/microsoft/" }, { "url": "https://www.facebook.com/samsung/" }, { "url": "https://www.facebook.com/starbucks/" }, { "url": "https://www.facebook.com/amazon/" }, { "url": "https://www.facebook.com/netflix/" }, { "url": "https://www.facebook.com/tesla/" }, { "url": "https://www.facebook.com/spotify/" }, { "url": "https://www.facebook.com/airbnb/" }, { "url": "https://www.facebook.com/uber/" }, { "url": "https://www.facebook.com/lyft/" }, { "url": "https://www.facebook.com/walmart/" }, { "url": "https://www.facebook.com/target/" }, { "url": "https://www.facebook.com/bestbuy/" }, { "url": "https://www.facebook.com/costco/" }, { "url": "https://www.facebook.com/homedepot/" }, { "url": "https://www.facebook.com/lowes/" }, { "url": "https://www.facebook.com/fedex/" }, { "url": "https://www.facebook.com/ups/" }, { "url": "https://www.facebook.com/dhl/" }, { "url": "https://www.facebook.com/visa/" }, { "url": "https://www.facebook.com/mastercard/" }, { "url": "https://www.facebook.com/paypal/" }, { "url": "https://www.facebook.com/americanexpress/" }, { "url": "https://www.facebook.com/chase/" }, { "url": "https://www.facebook.com/bankofamerica/" }, { "url": "https://www.facebook.com/wellsfargo/" }, { "url": "https://www.facebook.com/citi/" }, { "url": "https://www.facebook.com/sony/" }, { "url": "https://www.facebook.com/disney/" }, { "url": "https://www.facebook.com/marvel/" }, { "url": "https://www.facebook.com/lego/" }, { "url": "https://www.facebook.com/playstation/" }, { "url": "https://www.facebook.com/xboxone/" }, { "url": "https://www.facebook.com/ebay/" } ] }' | apify call parseforge/facebook-pages-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/facebook-pages-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/xKeGFcfLtBucHG3n9/builds/s7X8qQNkPgty8WPHs/openapi.json