# Facebook Followers Scraper (`khadinakbar/facebook-followers-scraper`) Actor Track public Facebook page follower count, like count, and page metadata in bulk. No login, no cookies. Provider-backed (ScrapeCreators primary, SociaVault fallback). MCP-ready. - **URL**: https://apify.com/khadinakbar/facebook-followers-scraper.md - **Developed by:** [Khadin Akbar](https://apify.com/khadinakbar) (community) - **Categories:** Social media, MCP servers, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 page trackeds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Followers Scraper Bulk-track public **Facebook page follower count, like count, and page metadata** without logging in. Give the actor one or more Facebook page URLs and it returns one flat record per page — name, follower count, like count, category, rating, contact details, profile/cover image URLs — perfect for competitor monitoring, social-listening dashboards, brand analytics, and AI-agent workflows that need fresh public Facebook page stats on demand. > **What this is NOT:** Facebook does not expose the public follower roster (the actual list of people who follow a page) without login. This actor returns the *counts and page metadata*, not the list of follower accounts. No actor anywhere can return the cookieless follower roster. **Why this exists.** Marketing teams, agencies, and analytics builders need cheap, reliable, bulk Facebook page stats. The platform's own Graph API is locked down. Other Facebook scrapers return everything (posts, reviews, photos, services) at $0.01+/page — overkill when you just want follower numbers across 200 competitors. This actor is the lean counterpoint: **$0.005 per page tracked**, flat JSON, MCP-ready. ### What it extracts Each dataset item is a single Facebook page: | Field | Type | Notes | |---|---|---| | `pageUrl` | string | Page URL you submitted (canonicalized) | | `name` | string | Display name | | `pageId` | string | Numeric Facebook ID | | `adLibraryPageId` | string | Cross-reference key for the Meta Ad Library | | `followerCount` | integer | Public follower count at scrape time | | `likeCount` | integer | Public page like count | | `category` | string | e.g. `Software Company`, `Restaurant` | | `isBusinessPageActive` | boolean | Whether Facebook marks the page as an active business page | | `adStatus` | string | e.g. `This Page is currently running ads.` | | `creationDate` | string | When Facebook says the page was created | | `pageIntro` | string | Short bio line from the profile header | | `address`, `email`, `phone`, `website` | string | Public contact details (when published) | | `rating`, `ratingCount` | number/int | Average star rating when exposed | | `priceRange` | string | Facebook price bucket (`$`, `$$`, `$$$`) | | `profilePicUrl`, `coverPhotoUrl` | string | Direct image URLs | | `businessHours` | object | Per-weekday open/close intervals (optional) | | `links` | array | Outbound page links (optional) | | `scrapeSource` | enum | `scrapecreators` or `sociavault` | | `scrapedAt` | string | ISO 8601 timestamp | Empty or unavailable fields are omitted from the record. The follower count is what social-media monitoring tools, dashboards, and CRMs need most — it's the headline metric of page health. ### Pricing | Event | Price | |---|---| | Actor start | $0.00005 | | Page tracked | **$0.005 per page** | A 100-page bulk run costs about **$0.50**. Pay-Per-Usage (compute + proxy passthrough) is also enabled — pick whichever model fits your job. No subscriptions, no monthly fees. ### How it works The actor is **provider-backed** for resilience. By default (`provider: "auto"`) it tries ScrapeCreators first, then falls back to SociaVault if the primary errors. Both providers read Facebook's public profile endpoint cookielessly, return JSON, and normalize into the flat schema above. The owner's provider API keys are pre-configured as environment variables; you do not supply a key. You can lock the actor to a single provider via the `provider` input: - `scrapeCreators` — force ScrapeCreators only - `sociaVault` — force SociaVault only - `auto` (default) — try ScrapeCreators, fall back to SociaVault ### Input ```json { "pageUrls": [ "https://www.facebook.com/Microsoft", "https://www.facebook.com/cocacola", "https://www.facebook.com/Nike" ], "includeContactDetails": true, "includeBusinessHours": false, "provider": "auto" } ```` | Field | Type | Required | Default | Notes | |---|---|---|---|---| | `pageUrls` | array | yes | — | Public Facebook page URLs | | `includeContactDetails` | boolean | no | `true` | Address, email, phone, website, links | | `includeBusinessHours` | boolean | no | `false` | Weekday opening hours for business pages | | `provider` | enum | no | `auto` | `auto` / `scrapeCreators` / `sociaVault` | ### Example output ```json { "pageUrl": "https://www.facebook.com/Microsoft", "name": "Microsoft", "pageId": "11320376584", "adLibraryPageId": "11320376584", "followerCount": 13800000, "likeCount": 13200000, "category": "Software Company", "isBusinessPageActive": true, "adStatus": "This Page is currently running ads.", "creationDate": "November 16, 2009", "website": "https://www.microsoft.com", "profilePicUrl": "https://scontent.xx.fbcdn.net/...", "coverPhotoUrl": "https://scontent.xx.fbcdn.net/...", "scrapeSource": "scrapecreators", "scrapedAt": "2026-06-27T06:51:23.512Z" } ``` ### Use cases - **Competitor follower tracking** — monitor 50 competitor Facebook pages weekly, plot follower growth in your BI tool. - **Brand analytics dashboards** — feed daily follower/like counts into Looker, Metabase, or Sigma. - **Influencer / sponsorship vetting** — confirm a page's real follower count before signing. - **Lead enrichment** — pull public contact details for local-business pages. - **AI agents** — Claude or ChatGPT calls this tool via [Apify MCP](https://mcp.apify.com) to answer "how many followers does X have?" in one shot. ### Bulk + MCP-ready Pass dozens or hundreds of URLs in one run; the actor processes them sequentially with provider-side rate limits. Output is flat, semantic, and small — under 500 tokens per record on average — so AI agents can sample many results without blowing their context budget. The actor is registered in the Apify MCP catalogue as `apify--facebook-followers-scraper`. Agents see it with a clear tool description, narrow input schema, and a published price-per-event so they can budget calls before firing them. ### Reliability - **Provider chain (SC → SV)** — when ScrapeCreators returns a transient error, SociaVault is tried automatically. - **Triple-guard PPE** — hard counter blocks over-charging past your input URL count. - **safePushData** — schema-rejection failures retry with a minimal record instead of dropping the whole batch. - **Soft-fail on bad input** — empty `pageUrls`, missing provider keys, etc. exit gracefully with a clear status message (no FAILED runs from user input). - **Honest-fail on provider exhaustion** — if every page errored at every provider, the run fails with a clear diagnostic instead of pretending to succeed empty. - **All 5 Apify schemas** — input, dataset, key-value store, output, pay-per-event. ### What this actor will NOT do - **Return a follower list / roster** — Facebook does not expose individual followers for public pages without login. This is a hard platform limitation; no scraper can do it cookielessly. - **Bypass login walls** — private pages, age-gated pages, and pages set to "members only" return no record. - **Scrape posts or comments** — use `khadinakbar/facebook-page-scraper` (full page details + recent posts), `khadinakbar/facebook-posts-scraper` (post feeds), or `khadinakbar/facebook-comments-scraper` (post comments) for those. - **Track followers historically** — each run is a point-in-time snapshot. Schedule the actor in Apify (daily/weekly) and store the timestamped output in your warehouse to build history. ### Related actors - [`facebook-page-scraper`](https://apify.com/khadinakbar/facebook-page-scraper) — full page profile + recent posts ($0.01/page) - [`facebook-posts-scraper`](https://apify.com/khadinakbar/facebook-posts-scraper) — feed of posts from a page - [`facebook-comments-scraper`](https://apify.com/khadinakbar/facebook-comments-scraper) — comments on a specific post or reel - [`facebook-ads-library-scraper`](https://apify.com/khadinakbar/facebook-ads-library-scraper) — what's running in the Meta Ad Library - [`meta-ad-library-scraper`](https://apify.com/khadinakbar/meta-ad-library-scraper) — same source, different actor ### Frequently asked **Can I get the list of accounts that follow a page?** No. Facebook does not expose this without an account login, and even logged in it's not a public list for most pages. This actor returns *counts and page metadata*. Any scraper claiming a cookieless full roster is either using stale data or about to break. **Does it work for personal profiles?** Yes for public profiles, with `followerCount` populated when the user has made their follower count visible. Most personal profiles do not publish contact details. **Will Facebook block me?** This actor never hits Facebook directly from your IP. Providers handle the request fan-out. There is nothing to block on your side. **How often can I run it?** As often as you want — schedule it daily, hourly, whatever. Cost scales linearly with input URLs, capped to your maxPpe budget. **Why both PPE and Pay-Per-Usage?** Some buyers want predictable per-page billing; others (very large jobs) prefer pure compute pricing. Both are enabled — you pick at run time. ### Legal Use this actor only to access information that is publicly available on Facebook. Do not use it to circumvent access controls, scrape login-walled content, or violate Meta's Terms of Service. You are responsible for complying with applicable data-protection laws (including GDPR, CCPA) for any contact details you collect. This actor is unaffiliated with Meta Platforms. ### Changelog - **1.0 (2026-06-27)** — Initial release. Provider-backed (ScrapeCreators primary + SociaVault fallback). Bulk page tracking with follower count, like count, category, ad status, contact details, profile/cover images. Optional business hours and contact-detail toggles. PPE triple-guard, safePushData, soft-fail validation, honest-fail on provider exhaustion. All 5 Apify schemas. MCP-ready. # Actor input Schema ## `pageUrls` (type: `array`): One or more public Facebook page or profile URLs to track (e.g. 'https://www.facebook.com/Microsoft' or 'https://www.facebook.com/cocacola'). Accepts plain URL strings or {"url": "..."} objects. NOT a single post or reel URL, NOT a group URL, NOT a Facebook follower-roster URL — Facebook does not expose the public follower list without login; this actor returns counts and page metadata. Private or deleted pages return no record. ## `includeContactDetails` (type: `boolean`): When enabled (default), returns the page's public contact details if visible: address, email, phone, website, and outbound links. Turn off for a leaner counts-only dataset. Many personal profiles do not expose these fields. ## `includeBusinessHours` (type: `boolean`): When enabled, returns the page's published opening hours (monday/tuesday/.../sunday open/close intervals) for business pages that publish them. Off by default for cleaner output. Only meaningful for business pages. ## `provider` (type: `string`): Which backend reads the public Facebook page profile. 'auto' tries ScrapeCreators first then falls back to SociaVault on failure. Pick a single provider to force it. The owner's API keys are pre-configured as environment variables; you do not supply a key. NOT a Facebook login. ## Actor input object example ```json { "pageUrls": [ "https://www.facebook.com/Microsoft" ], "includeContactDetails": true, "includeBusinessHours": false, "provider": "auto" } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `summary` (type: `string`): No description ## `runSummary` (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/Microsoft", "https://www.facebook.com/cocacola" ] }; // Run the Actor and wait for it to finish const run = await client.actor("khadinakbar/facebook-followers-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/Microsoft", "https://www.facebook.com/cocacola", ] } # Run the Actor and wait for it to finish run = client.actor("khadinakbar/facebook-followers-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/Microsoft", "https://www.facebook.com/cocacola" ] }' | apify call khadinakbar/facebook-followers-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=khadinakbar/facebook-followers-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Followers Scraper", "description": "Track public Facebook page follower count, like count, and page metadata in bulk. No login, no cookies. Provider-backed (ScrapeCreators primary, SociaVault fallback). MCP-ready.", "version": "1.0", "x-build-id": "LETeNbGQLQ0dX2rQV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~facebook-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-facebook-followers-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/khadinakbar~facebook-followers-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-facebook-followers-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/khadinakbar~facebook-followers-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-facebook-followers-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": "One or more public Facebook page or profile URLs to track (e.g. 'https://www.facebook.com/Microsoft' or 'https://www.facebook.com/cocacola'). Accepts plain URL strings or {\"url\": \"...\"} objects. NOT a single post or reel URL, NOT a group URL, NOT a Facebook follower-roster URL — Facebook does not expose the public follower list without login; this actor returns counts and page metadata. Private or deleted pages return no record.", "items": { "type": "string" } }, "includeContactDetails": { "title": "Include contact details", "type": "boolean", "description": "When enabled (default), returns the page's public contact details if visible: address, email, phone, website, and outbound links. Turn off for a leaner counts-only dataset. Many personal profiles do not expose these fields.", "default": true }, "includeBusinessHours": { "title": "Include business hours", "type": "boolean", "description": "When enabled, returns the page's published opening hours (monday/tuesday/.../sunday open/close intervals) for business pages that publish them. Off by default for cleaner output. Only meaningful for business pages.", "default": false }, "provider": { "title": "Data provider", "enum": [ "auto", "scrapeCreators", "sociaVault" ], "type": "string", "description": "Which backend reads the public Facebook page profile. 'auto' tries ScrapeCreators first then falls back to SociaVault on failure. Pick a single provider to force it. The owner's API keys are pre-configured as environment variables; you do not supply a key. NOT a Facebook login.", "default": "auto" } } }, "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 } } } } } } } } } } ```