# Facebook Pages Scraper (`automation-lab/facebook-pages-scraper`) Actor Scrape public Facebook Pages — extract followers, likes, contact info, website, description, hours, and more. No login required. Powered by residential proxy for reliable access. - **URL**: https://apify.com/automation-lab/facebook-pages-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Social media - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## 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. 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 Pages Scraper Extract public data from Facebook Pages — followers, likes, contact info, website, description, and more. No login required. Works with any public Facebook Page URL. ### 🚀 What does it do? Facebook Pages Scraper loads public Facebook Pages and extracts structured data from each page, including: - **Page identity**: name, page ID, URL, verified status - **Engagement**: follower count, like count, check-in count - **Contact**: website, email, phone number - **Description**: about text, category - **Media**: profile picture URL, cover photo URL - **Location**: address, city, state, country - **Social links**: Instagram, Twitter/X, YouTube - **Recent posts** (optional): text preview from latest posts ### 👥 Who is it for? #### Market researchers Track competitor Facebook pages, monitor follower growth, and analyze engagement metrics across brands and industries. #### Lead generation agencies Extract contact information (website, email, phone) from business Facebook pages at scale. #### Social media managers Audit Facebook Pages for clients — check follower counts, verify contact info, and benchmark against competitors. #### Data analysts & BI teams Build databases of brand presence on Facebook — who's verified, how big they are, what categories they're in. #### PR and communications teams Monitor brand pages and track their public-facing information across campaigns. ### 💡 Why use this scraper? Facebook removed public API access to Page data in 2018/2019 (Graph API v3.0+). The **only** way to get Page data programmatically is through scraping. This tool: - ✅ Requires **no Facebook account** — works with public pages - ✅ Uses **residential proxy** — gets past Facebook's IP-based blocks - ✅ Extracts **accurate follower counts** directly from page rendering - ✅ Handles **100+ pages per run** efficiently - ✅ Returns **clean, structured JSON** — no post-processing needed ### 📊 What data do you get? | Field | Type | Description | |-------|------|-------------| | `name` | string | Page display name | | `pageId` | string | Facebook numeric page ID | | `pageName` | string | URL slug (username) | | `url` | string | Full Facebook page URL | | `category` | string | Page category (if available) | | `description` | string | About text / meta description | | `followers` | number | Follower count | | `likes` | number | Page like count | | `checkins` | number | Check-in count | | `verified` | boolean | Blue verification badge | | `website` | string | Linked external website | | `email` | string | Contact email (if public) | | `phone` | string | Contact phone (if public) | | `address` | string | Physical address (if listed) | | `city` | string | City (from address) | | `state` | string | State/region | | `country` | string | Country | | `profilePictureUrl` | string | Profile photo URL | | `coverPhotoUrl` | string | Cover photo URL | | `instagramUrl` | string | Linked Instagram | | `twitterUrl` | string | Linked Twitter/X | | `youtubeUrl` | string | Linked YouTube | | `priceRange` | string | Price range ($ to $$$$) | | `recentPosts` | array | Recent post previews (optional) | | `scrapedAt` | string | ISO timestamp of scrape | ### 💰 How much does it cost to scrape Facebook pages? This actor uses **Pay Per Event (PPE)** pricing — you pay only for data you extract. | Event | FREE tier | BRONZE | SILVER | GOLD | PLATINUM | DIAMOND | |-------|-----------|--------|--------|------|----------|---------| | Run start | $0.01 | $0.0095 | $0.0085 | $0.0075 | $0.006 | $0.005 | | Per page scraped | $0.15 | $0.135 | $0.125 | $0.12 | $0.115 | $0.11 | > **Why is Facebook scraping expensive?** Facebook requires residential proxies (~$8/GB) to bypass IP blocks, and their JS-heavy pages send ~5–10MB of traffic per page through the proxy. This is the industry-standard cost for any Facebook scraper — the price reflects real infrastructure costs, not arbitrary markup. **Example costs:** - 10 pages → ~$1.51 (start fee + 10 × $0.15) - 100 pages → ~$15.01 - 500 pages → ~$75.01 ### 🔧 How to scrape Facebook Pages #### Step 1: Prepare your list of page URLs Collect the Facebook page URLs you want to scrape: - Named pages: `https://www.facebook.com/cocacola` - Numeric IDs: `https://www.facebook.com/profile.php?id=100064277875532` #### Step 2: Configure the actor 1. Paste your page URLs into the **Facebook page URLs** field (one per line) 2. Set **Max pages** to control how many to process 3. Enable **Include recent posts** if you want post text previews 4. Set **Proxy country** (US recommended) #### Step 3: Run and download results Click **Start** and results will appear in the **Dataset** tab as they're scraped. ### ⚙️ Input options | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `pageUrls` | array | required | Facebook page URLs to scrape | | `maxPages` | integer | 50 | Maximum number of pages to process | | `includeRecentPosts` | boolean | false | Include up to 3 recent post previews | | `proxyCountry` | string | US | Residential proxy country code | #### Example input ```json { "pageUrls": [ "https://www.facebook.com/cocacola", "https://www.facebook.com/starbucks", "https://www.facebook.com/McDonalds" ], "maxPages": 50, "includeRecentPosts": false, "proxyCountry": "US" } ```` ### 📤 Output format Each scraped page produces one JSON record in the dataset: ```json { "pageId": "100064277875532", "name": "Coca-Cola", "pageName": "cocacola", "url": "https://www.facebook.com/cocacola", "category": "Soft Drink Company", "description": "The Coca-Cola Facebook Page is a collection of your stories showing how people from around the world are refreshed by Coca-Cola.", "website": "https://www.coca-cola.com/", "email": null, "phone": null, "address": null, "followers": 108000000, "likes": 108174765, "checkins": null, "verified": true, "profilePictureUrl": "https://scontent.xx.fbcdn.net/...", "coverPhotoUrl": null, "instagramUrl": null, "twitterUrl": null, "youtubeUrl": null, "priceRange": null, "recentPosts": [], "scrapedAt": "2026-04-06T01:00:00.000Z" } ``` ### 💡 Tips for best results #### Getting more data - **Category**: visible on About section for business/brand pages - **Contact info**: only appears for business pages that have listed it publicly - **Posts**: enable `includeRecentPosts` for a preview of recent content #### Performance tips - Process pages in batches of 50-100 for best efficiency - Use `proxyCountry` matching the target pages' primary audience #### Page URL formats - Named: `https://www.facebook.com/pageName` - Numeric: `https://www.facebook.com/100064277875532` - With www: both work the same way ### 🔗 Integrations #### Export to Google Sheets Connect this actor to **Google Sheets** via Apify's integration: 1. Run the actor 2. In the **Integrations** tab, choose "Export to Google Sheets" 3. Your dataset is automatically added to a spreadsheet #### CRM automation Feed page data into HubSpot, Salesforce, or any CRM via Zapier: 1. Connect the actor via Zapier's Apify trigger 2. Map fields to your CRM properties #### Scheduled monitoring Track Facebook page growth over time: 1. Schedule the actor to run weekly/monthly 2. Save each run's dataset with a timestamp 3. Compare follower counts across runs ### 🤖 API usage #### Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('automation-lab/facebook-pages-scraper').call({ pageUrls: [ 'https://www.facebook.com/cocacola', 'https://www.facebook.com/starbucks', ], maxPages: 10, proxyCountry: 'US', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_API_TOKEN') run = client.actor('automation-lab/facebook-pages-scraper').call(run_input={ 'pageUrls': [ 'https://www.facebook.com/cocacola', 'https://www.facebook.com/starbucks', ], 'maxPages': 10, 'proxyCountry': 'US', }) items = client.dataset(run['defaultDatasetId']).list_items().items for item in items: print(item['name'], item['followers']) ``` #### cURL ```bash curl -X POST \ "https://api.apify.com/v2/acts/automation-lab~facebook-pages-scraper/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "pageUrls": ["https://www.facebook.com/cocacola"], "maxPages": 5, "proxyCountry": "US" }' ``` ### 🤖 MCP (Model Context Protocol) Use this actor with AI assistants like **Claude** for natural language page scraping: #### Claude Code (terminal) ```bash claude mcp add --transport http apify https://mcp.apify.com?tools=automation-lab/facebook-pages-scraper ``` #### Claude Desktop / Cursor / VS Code Add to your MCP server config: ```json { "mcpServers": { "apify": { "command": "npx", "args": ["-y", "@apify/mcp-server"], "env": { "APIFY_TOKEN": "YOUR_TOKEN" } } } } ``` Then ask Claude: - *"Scrape the Facebook page for Coca-Cola and give me their follower count and website"* - *"Get contact info from these 5 Facebook pages: \[list URLs]"* - *"Which of these brands has the most Facebook followers?"* Or use the actor-specific MCP URL: ``` https://mcp.apify.com?tools=automation-lab/facebook-pages-scraper ``` ### ⚖️ Is scraping Facebook Pages legal? This actor only accesses **publicly available** data from Facebook Pages — the same data anyone can view without logging in. We do not: - Access private profiles or locked content - Use login credentials - Scrape personal user data or friend lists - Violate Facebook's data protection rules for private data Public business pages are designed to be seen. Scraping their public-facing information (name, contact details, follower counts) is lawful in most jurisdictions, though you should verify local laws apply to your use case. See our [terms of service](https://apify.com/terms) and consult legal counsel for commercial applications. ### ❓ FAQ #### Why are some fields null? Facebook uses JavaScript rendering for much of its content. Some data — especially category, phone, and email — only appears after the page fully renders. The scraper waits for rendering to complete, but for large brand pages these fields may not be publicly listed. #### Why is the follower count rounded (e.g., 34,000,000 instead of 34,339,332)? Facebook shows large counts abbreviated (e.g., "34M followers") on some page views, which we display as-is. The `likes` field typically shows the precise count from meta tags. #### Can I scrape private Facebook pages? No. This actor only works with public pages — those visible without a Facebook account. #### Why does the scraper use residential proxy? Facebook blocks datacenter IP ranges with a 302 redirect. Residential proxies bypass this at a modest cost. #### I got "Facebook" as the page name for some URLs This happens when the URL doesn't correspond to an actual public page, causing Facebook to redirect to its homepage. Check that your URLs are valid and the pages are public. #### How many pages can I scrape per run? There's no hard limit, but for cost and reliability we recommend runs of 50-200 pages. Use the `maxPages` setting to control batch size. ### 🔗 Related scrapers - [Facebook Ads Library Scraper](https://apify.com/automation-lab/facebook-ads-library) — Scrape Facebook Ad Library for competitor ads - [Instagram Scraper](https://apify.com/automation-lab/instagram-scraper) — Extract Instagram profile and post data - [LinkedIn Company Scraper](https://apify.com/automation-lab/linkedin-company-scraper) — Scrape LinkedIn company pages # Actor input Schema ## `pageUrls` (type: `array`): Enter Facebook page URLs to scrape (e.g. "https://www.facebook.com/cocacola" or "https://www.facebook.com/123456789"). Accepts both named pages and numeric page IDs. ## `maxPages` (type: `integer`): Maximum number of pages to scrape. Useful to cap costs when scraping large lists. ## `includeRecentPosts` (type: `boolean`): Scrape up to 3 recent post previews from each page (text, date, engagement counts). Adds a few seconds per page. ## `proxyCountry` (type: `string`): ISO country code for residential proxy (e.g. "US", "GB", "DE"). Controls which country's Facebook content is shown. ## Actor input object example ```json { "pageUrls": [ "https://www.facebook.com/cocacola" ], "maxPages": 5, "includeRecentPosts": false, "proxyCountry": "US" } ``` # Actor output Schema ## `overview` (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/cocacola" ], "maxPages": 5, "proxyCountry": "US" }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/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 = { "pageUrls": ["https://www.facebook.com/cocacola"], "maxPages": 5, "proxyCountry": "US", } # Run the Actor and wait for it to finish run = client.actor("automation-lab/facebook-pages-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/cocacola" ], "maxPages": 5, "proxyCountry": "US" }' | apify call automation-lab/facebook-pages-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/facebook-pages-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Pages Scraper", "description": "Scrape public Facebook Pages — extract followers, likes, contact info, website, description, hours, and more. No login required. Powered by residential proxy for reliable access.", "version": "0.1", "x-build-id": "84QeAUNKn07kZcAcw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~facebook-pages-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-facebook-pages-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/automation-lab~facebook-pages-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-facebook-pages-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/automation-lab~facebook-pages-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-facebook-pages-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": "📄 Facebook page URLs", "type": "array", "description": "Enter Facebook page URLs to scrape (e.g. \"https://www.facebook.com/cocacola\" or \"https://www.facebook.com/123456789\"). Accepts both named pages and numeric page IDs.", "items": { "type": "string" } }, "maxPages": { "title": "⚙️ Max pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of pages to scrape. Useful to cap costs when scraping large lists.", "default": 50 }, "includeRecentPosts": { "title": "📝 Include recent posts", "type": "boolean", "description": "Scrape up to 3 recent post previews from each page (text, date, engagement counts). Adds a few seconds per page.", "default": false }, "proxyCountry": { "title": "🌍 Proxy country", "type": "string", "description": "ISO country code for residential proxy (e.g. \"US\", \"GB\", \"DE\"). Controls which country's Facebook content is shown.", "default": "US" } } }, "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 } } } } } } } } } } ```