# Facebook Followers Scraper (`scrapeflux/facebook-followers-scraper`) Actor Facebook Followers Scraper extracts publicly available follower data from Facebook pages and profiles. Collect follower counts, page information, engagement metrics, profile details, and audience insights for competitor analysis, influencer research, market intelligence, and social media marketing. - **URL**: https://apify.com/scrapeflux/facebook-followers-scraper.md - **Developed by:** [ScrapeFlux](https://apify.com/scrapeflux) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Followers Scraper 🚀 — Get Follower Lists from Facebook Profiles Without Manual Scrolling If you’re trying to scrape Facebook follower count or build a targeted audience list, manually collecting follower data is slow, inconsistent, and easy to mess up. **Facebook Followers Scraper** pulls follower data from a Facebook profile URL for you, in bulk, with dataset-ready output. This facebook followers extractor is built for marketers, researchers, and data teams who need a facebook followers scraper that can scale. Run it once and you can capture up to your chosen maximum number of followers in a single job, with results written continuously as the actor progresses. --- ### See the Data: Sample Output Here's a real record from a single run: ```json { "url": "https://web.facebook.com/some.follower.profile/", "title": "Some Follower Name", "image_uri": "https://external-preview.some.domain/picture.jpg", "id": "1234567890", "data_type": "follower", "base_url": "https://web.facebook.com/someTargetProfile", "status": "success" } ```` Below is what the actor extracts per follower item (and what you’ll see in your dataset): | Field | Type | What It Tells You | |---|---|---| | `url` | string | Direct profile link for the follower, useful for reference and validation | | `title` | string | null | The display text/title associated with the follower (when available) | | `image_uri` | string | null | Follower image URI (helpful for enrichment or UI previews) | | `id` | string | null | Follower identifier returned by the source data | | `data_type` | string | Identifies that the record is a follower (set to `"follower"`) | | `base_url` | string | The `startUrl` you provided, so you always know what the follower came from | | `status` | string | Indicates whether the record was successfully produced for your run | | `collection_id` | string | null | The internal collection identifier used for pagination (dataset-level context) | | `collection_url` | string | The followers collection URL context captured during extraction | | `cursor` | string | null | Pagination cursor used to continue fetching additional followers (when applicable) | | `has_next_page` | boolean | Whether more pages were available during pagination | | `matched_target` | boolean | Whether the actor found the collection specifically associated with the `/followers` context | | `error_message` | string | null | Populated only when the actor encounters an error during fetching or pagination | Export your full dataset as JSON, CSV, or Excel from the Apify dashboard. *** ### Setting It Up Drop this into your `input.json` and you're ready to go: ```json { "startUrl": "https://web.facebook.com/leomessi", "maxItems": 200, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ``` | Parameter | Required | What It Does | |---|---|---| | `startUrl` | ✅ | The Facebook profile URL to scrape followers from | | `maxItems` | ⬜ | Caps the maximum number of followers to scrape (minimum is 1; default is 200) | | `proxyConfiguration` | ⬜ | Proxy settings for the run (used to request the profile page and continue pagination) | | ↳ `proxy support` | ⬜ | Enables Apify Proxy routing for better reliability | | ↳ `proxy support` | ⬜ | Chooses the proxy group(s) to use (for example, `RESIDENTIAL`) | *** ### What It Does Facebook Followers Scraper extracts follower items from a Facebook profile URL and writes structured records into your Apify dataset. It supports pagination so you can keep collecting until you reach your `maxItems` limit. #### Pull follower items directly from a profile page You provide a `startUrl`, and the actor extracts follower entries from the profile’s followers context. Each follower record includes fields like `url`, `title`, `image_uri`, and `id`, along with `data_type` and `base_url`. #### Keep fetching until you hit your limit If more pages are available, the actor continues collecting followers using pagination and stops when it reaches `maxItems` (or no further pages exist). This makes it a practical facebook follower count scraper workflow when you need more than a quick snapshot. #### Clean, dataset-ready output for analysis & outreach Every follower item is pushed to your dataset as a JSON object, with consistent field names. That means you can load results into spreadsheets, CRMs, or downstream data pipelines without reformatting. #### Built-in proxy support for reliable scraping The actor uses proxy configuration and updates proxies during pagination so long scraping runs are more stable. This helps when you need a bulk facebook followers scraper experience without babysitting your session. #### Includes retries and stops safely on failures The actor uses retries for both the initial page fetch and subsequent pagination requests, and it stops pagination when it can’t continue. If no relevant followers context is found, it warns and falls back to extraction so you still get output where possible. Overall, Facebook Followers Scraper helps you scrape Facebook followers in a repeatable way—so you can move from a profile URL to a usable dataset fast. *** ### Why Facebook Followers Scraper? There are plenty of ways to pull data from Facebook — here’s why Facebook Followers Scraper stands out. #### Built for “get results” rather than manual collection You start with one `startUrl` and a clear `maxItems` cap, and the actor does the rest while writing results to your dataset. If your workflow is scraping facebook followers at scale, this avoids the tedious manual copying that slows campaigns down. #### Strong pagination handling for deeper follower lists Pagination is built into the actor flow so it can collect beyond the first batch of extracted items. That makes this facebook followers extractor more useful when you need larger follower datasets, not just a first page. #### Practical output fields for downstream work The follower records include `url`, `title`, `image_uri`, `id`, plus `data_type` and `base_url`. This structure supports enrichment, deduping, and joining to other datasets without extra parsing steps. *** ### Real-World Use Cases Here's how different teams put Facebook Followers Scraper to work: **Growth & Acquisition Teams**\ A growth marketer needs to scrape Facebook followers for multiple competitors to identify overlap and potential audience segments. They run Facebook Followers Scraper per target profile, cap results with `maxItems`, and export the dataset to enrich targeting lists faster than manual research. **Marketing Agencies**\ An agency supporting several clients wants a repeatable deliverable: a follower list tied to each client’s chosen profile URLs. The team uses Facebook followers extractor output (`url`, `image_uri`, and `id`) to produce clean datasets that can be shared or imported into client systems. **Sales & Prospecting Researchers**\ A lead researcher uses facebook followers scraper results to build prospect candidate pools for outreach and market mapping. By exporting the follower dataset, they can filter by profile links and integrate with their existing lead scoring logic. **Data Analysts & Enrichment Pipelines**\ A data analyst needs structured follower records for analysis, deduplication, and joins with internal tables. Using the actor’s consistent JSON fields, they can combine follower `id` values with other datasets in a repeatable pipeline. **Automation & Developer Workflows**\ A developer triggers runs via the Apify API and feeds results into an automation chain. Facebook Followers Scraper becomes a dependable component in a larger “scrape facebook followers → transform → store” workflow for bulk operations. *** ### How to Run It No code required. Here's how to get your first results in under 5 minutes: 1. **Open the actor on Apify**\ Go to [console.apify.com](https://console.apify.com) and open the Facebook Followers Scraper actor page. 2. **Enter your inputs**\ Set `startUrl` to the Facebook profile URL you want to scrape followers from. Optionally set `maxItems` to control how many follower items to collect. 3. **Configure proxy settings**\ Use the `proxyConfiguration` options to enable Apify Proxy routing for better reliability on longer runs. 4. **Start the run and watch the live log**\ Launch the actor and monitor the logs for progress, including whether pagination continues. 5. **Open the Dataset tab to see live results**\ As records are pushed during the run, you can review follower entries immediately. 6. **Export in your preferred format**\ Download the dataset from the Apify dashboard in your chosen format for analysis or importing elsewhere. The whole setup takes under 5 minutes — results start appearing within seconds of launch. *** ### Export & Integration Options Once your data is collected, Facebook Followers Scraper fits directly into your existing workflow. You can export your full dataset as **JSON, CSV, or Excel** from the Apify dataset tab. For teams that rely on spreadsheets or CRM workflows, that’s usually the fastest path to “ready to use” output. You can also connect the actor to your systems via **Apify API**, **webhooks**, and **no-code automation** like **Zapier** or **Make** to move results into your tools automatically. For more advanced setups, you can schedule runs so follower scraping happens on a cadence without manual triggers. *** ### Pricing Facebook Followers Scraper runs on Apify, which includes a **free tier** — no credit card needed to start. Apify offers a free tier with $5 platform credits on sign-up, enough for several real test runs. After that, runs are billed per Actor compute unit (CU), and you can use Apify plans for heavier workloads. No per-row markup is required—your cost is tied to platform compute. Start free at [apify.com](https://apify.com) — scale up when you need to. *** ### Reliability & Limitations | What We Handle | How | |---|---| | Rate-limit and access variability | Uses proxy configuration to improve consistency across requests | | Pagination continuation | Fetches additional follower items when more pages are available | | Temporary request failures | Retries key fetch and pagination steps to reduce interruptions | | Partial outputs | Writes follower records to the dataset as it goes, so you keep progress | | Pagination stopping conditions | Stops when it can’t continue pagination or when no new items are returned | Limitations: The actor depends on publicly available data and may return fewer items if the followers content isn’t accessible in the expected way. It doesn’t provide access to private, login-gated, or otherwise restricted profile content. For enterprise-scale needs or custom configurations, reach out and we'll help. *** ### Frequently Asked Questions #### Is there a free plan? Yes. Apify offers a free tier so you can run Facebook Followers Scraper and test with real data before scaling up. #### Do I need to log in or create an account on Facebook? No. This actor is designed to work with publicly available content from a Facebook profile URL, without requiring you to log in. #### How accurate is the extracted data? Accuracy depends on what’s available in the public follower listings for the profile you provide. The actor extracts fields such as `url`, `title`, `image_uri`, and `id` when they appear in the source data. #### How many results can I get per run? You can control the maximum number of follower items using `maxItems`. The actor will stop collecting once it reaches your cap. #### How fresh is the data? The data freshness corresponds to when you run the actor. If follower lists change over time, running a new job will reflect the latest publicly available state at that time. #### Is this legal? Does it comply with GDPR / CCPA? Use is subject to your local laws and Facebook’s terms. The actor collects data only from **publicly available data**, and you’re responsible for how you store, process, and use it under GDPR, CCPA, and applicable regulations. #### Can I export to Google Sheets or Excel? Yes. You can export your dataset from the Apify dashboard as JSON, CSV, or Excel, and then import into Google Sheets or any compatible tool. #### Can I schedule this to run automatically? Yes. On Apify, you can schedule actor runs so Facebook followers scraping can happen automatically on a cadence. #### Can I access results via the API? Yes. You can retrieve results programmatically using the Apify API and integrate Facebook Followers Scraper into your own data pipelines. #### What happens when the actor encounters an error? The actor uses retries for fetching and pagination steps, and it stops pagination when it can’t continue. Results that were already pushed to the dataset remain available for export. *** ### Get Help & Use Responsibly Got a question about Facebook Followers Scraper or a feature you’d like added? Reach out at — we actively maintain this actor and respond to feedback. If you want enhancements like improved dataset consistency for different profile pages or clearer run-stop behavior, tell us what you need. **publicly available data** — the actor does not access private accounts, login-gated pages, or password-protected content. Please make sure your usage complies with GDPR, CCPA, and Facebook’s Terms of Service. For data removal requests, contact . Use responsibly, ethically, and only for lawful purposes. # Actor input Schema ## `startUrl` (type: `string`): The URL of the Facebook profile to scrape followers from. ## `maxItems` (type: `integer`): Maximum number of followers to scrape. ## Actor input object example ```json { "startUrl": "https://web.facebook.com/leomessi", "maxItems": 200 } ``` # 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 = { "startUrl": "https://web.facebook.com/leomessi" }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeflux/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 = { "startUrl": "https://web.facebook.com/leomessi" } # Run the Actor and wait for it to finish run = client.actor("scrapeflux/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 '{ "startUrl": "https://web.facebook.com/leomessi" }' | apify call scrapeflux/facebook-followers-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflux/facebook-followers-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Facebook Followers Scraper", "description": "Facebook Followers Scraper extracts publicly available follower data from Facebook pages and profiles. Collect follower counts, page information, engagement metrics, profile details, and audience insights for competitor analysis, influencer research, market intelligence, and social media marketing.", "version": "1.0", "x-build-id": "XLzIKC4X8cjJ4i5SV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflux~facebook-followers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflux-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/scrapeflux~facebook-followers-scraper/runs": { "post": { "operationId": "runs-sync-scrapeflux-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/scrapeflux~facebook-followers-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeflux-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": [ "startUrl" ], "properties": { "startUrl": { "title": "Facebook Profile URL", "type": "string", "description": "The URL of the Facebook profile to scrape followers from." }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Maximum number of followers to scrape.", "default": 200 } } }, "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 } } } } } } } } } } ```