Facebook Followers Scraper

Facebook Followers Scraper

Facebook Followers Scraper is an Apify actor that extracts public follower data from Facebook profile or page follower lists at scale. It solves the manual, error-prone process of scrolling and copying by programmatically collecting structured follower profiles for audience analysis, competitor research, and lead generation. Built for marketers, developers, data analysts, and researchers, it normalizes inputs (full URLs or usernames), paginates through results via GraphQL, and exports clean datasets you can use in workflows and APIs.

What data / output can you get?

Below are the exact fields pushed to the Apify Dataset during a run. You can download results as JSON or CSV directly from Apify. Each row represents a follower profile.

Data type	Description	Example value
id	Unique identifier of the follower (from GraphQL)	61583319984594
name	Full display name extracted from the follower card	John Doe
short_name	First token of the name for quick labeling	John
url	Direct link to the follower’s Facebook profile	https://www.facebook.com/john.doe
image	Profile image URL (if available)	https://scontent.xx.fbcdn.net/...
gender	Gender parsed from the profile page (may be UNKNOWN)	MALE
subtitle_text	Short public bio/affiliation line shown on the card	Works at Company Name
friendship_status	Relationship status placeholder (currently null)	null
title	Internal duplicate of name (captured from the card title)	John Doe

Note: Some fields may be missing or return “UNKNOWN” when not publicly visible. You can export datasets in JSON or CSV from the Apify platform.

Key features

• ⚡ Intelligent proxy fallback The scraper starts with a direct connection and automatically falls back to Apify datacenter → residential proxies upon blocking. Once a fallback occurs, it sticks to that proxy type for stability.

• 🧭 Flexible input handling Accepts full follower URLs, profile URLs, or plain usernames (e.g., mrbeast). Inputs are normalized to the correct /followers URL before scraping.

• 📄 Paged GraphQL collection Efficiently iterates follower pages via the Facebook GraphQL endpoint, collecting data in batches with cursors.

• 🧵 Concurrent enrichment Fetches gender from follower profile pages concurrently (batched), improving throughput while keeping server load in check.

• 🎯 Configurable limits and retries Control the number of followers to collect per profile (maxFollowers) and how many retry attempts to use (maxRetries).

• 💾 Incremental dataset output Followers are pushed to the Apify Dataset as they’re collected, so you can inspect partial results mid-run.

• 🔌 API-ready on Apify Use the Apify API to trigger runs, fetch datasets in JSON/CSV, and integrate the actor in pipelines and schedulers.

• 🛡 Robust by design Built with async HTTP requests, retry logic, and sensible delays to balance performance and resilience.

How to use Facebook Followers Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Facebook Followers Scraper actor in the Apify Console.
3. Add input:
   • In startUrls, paste Facebook follower URLs, profile URLs, or plain usernames (e.g., https://www.facebook.com/username/followers, https://www.facebook.com/username, or mrbeast).
4. Configure key settings:
   • maxFollowers to set how many followers to collect per profile (1–1000, default 100).
   • proxyConfiguration if you want to enable the automatic proxy fallback behavior.
   • maxRetries to adjust retry attempts for network or blocking errors (default 3).
   • sortOrder and maxComments are available for future/conditional behavior if supported by the platform.
5. Start the run. The actor will normalize inputs, page through the follower list, and push follower items to the Dataset incrementally.
6. Monitor progress in the Apify run UI (logs will show pagination and collection stats).
7. Download results from the Dataset tab as JSON or CSV, or access them via the Apify API.

Pro tip: Schedule runs and pipe results into your analytics stack with the Apify API to automate audience monitoring and reporting.

Use cases

Use case name	Description
Social media analytics + benchmarking	Track and compare follower audiences across profiles to inform content strategy and measure growth.
Lead generation for marketing	Build lists of public follower profiles to identify potential audiences for outreach.
Competitor research	Analyze who follows competitor pages or profiles to understand interests and affinities.
Audience enrichment for BI	Export structured follower profiles and join with internal data for segmentation and reporting.
API-driven data pipelines	Trigger runs via the Apify API and stream datasets into warehouses or dashboards.
Academic or nonprofit research	Collect public follower datasets for research on communities, interests, and public behaviors.

Why choose Facebook Followers Scraper?

This actor delivers precision and automation for follower collection without brittle browser extensions.

• 🎯 Accurate, structured data: Collects IDs, names, profile URLs, images, subtitles, and gender in a consistent schema.
• 🌐 Automatic proxy fallback: Starts direct, then escalates to datacenter and residential proxies if blocked.
• 📈 Scales with you: Batch pagination, concurrent enrichment, and incremental dataset writes.
• 💻 Developer-friendly: API-ready on Apify for CI/CD, schedulers, and integration in data workflows.
• 🛡 Responsible by default: Targets publicly available follower lists and profile pages.
• 💸 Cost-effective alternative: More stable than manual tools and browser plugins, with reproducible, exportable datasets.
• 🔗 Seamless exports: Download JSON or CSV from the Apify Dataset for analysis or CRM import.

Bottom line: a production-grade follower scraper that balances speed, reliability, and structured outputs.

Is it legal / ethical to use Facebook Followers Scraper?

Yes — when used responsibly. The actor targets publicly available follower information that users have chosen to make visible. As with any data collection:

• Only collect and use public data; do not attempt to access private or restricted content.
• Comply with Facebook’s terms and applicable data protection laws (e.g., GDPR, CCPA).
• Avoid spam and misuse; use data for legitimate research or business purposes.
• Consult your legal team for edge cases or regulated environments.

The tool does not log in or access private areas — it fetches public follower lists and profile pages.

Input parameters & output format

Example JSON input

{
  "startUrls": [
    { "url": "https://www.facebook.com/real.dylan.thibert/followers" },
    "mrbeast"
  ],
  "maxFollowers": 100,
  "sortOrder": "default",
  "maxComments": 0,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxRetries": 3
}

Parameters

• startUrls (array) — List of Facebook profiles to scrape. Accepts full follower URLs (https://www.facebook.com/username/followers), profile URLs (https://www.facebook.com/username), or just usernames (mrbeast). Supports bulk input.

  • Default: none
  • Required: Yes

• maxFollowers (integer) — Maximum number of followers to extract from each profile (1–1000).

  • Default: 100
  • Required: No

• sortOrder (string) — How to sort followers (if supported by platform). One of: default, recent, alphabetical.

  • Default: "default"
  • Required: No

• maxComments (integer) — Maximum number of comments to extract (if applicable).

  • Default: 0
  • Required: No

• proxyConfiguration (object) — Proxy settings. Default: no proxy. Automatically falls back to datacenter → residential if blocked. Once fallback occurs, sticks with that proxy.

  • Default: { "useApifyProxy": false }
  • Required: No

• maxRetries (integer) — Number of retry attempts with residential proxy (1–10).

  • Default: 3
  • Required: No

Example JSON output (dataset items)

[
  {
    "id": "61583319984594",
    "image": "https://scontent.xx.fbcdn.net/...",
    "title": "John Doe",
    "subtitle_text": "Works at Company Name",
    "url": "https://www.facebook.com/john.doe",
    "friendship_status": null,
    "name": "John Doe",
    "short_name": "John",
    "gender": "MALE"
  }
]

Notes:

• friendship_status is currently returned as null.
• gender may be "UNKNOWN" if it cannot be determined from the public profile.
• The actor also stores a run summary in the key-value store under the key OUTPUT with fields like total_profiles_processed, total_followers, total_pages, proxy_used, proxy_type, and per-profile stats.

FAQ

Do I need to log in to use the Facebook Followers Scraper?

No. The actor scrapes publicly available follower lists and profile pages without logging in. It does not access private or authenticated content.

What fields are included in the output?

Each follower item includes: id, name, short_name, url, image, gender, subtitle_text, friendship_status, and title. Some values may be missing or “UNKNOWN” if not publicly visible.

How many followers can I scrape per profile?

You can control this with maxFollowers (1–1000). The default is 100 per profile.

Can I input just a username instead of a full URL?

Yes. You can provide plain usernames (e.g., mrbeast), profile URLs, or full follower URLs. The actor normalizes inputs to the correct /followers page automatically.

How does the proxy fallback work?

If you enable proxyConfiguration with useApifyProxy, the actor starts with a direct connection and automatically falls back to Apify datacenter proxies, then residential proxies if blocking occurs. Once it switches, it stays on that proxy type for the rest of the run.

In what formats can I export the data?

You can export the Apify Dataset as JSON or CSV from the Apify platform or fetch it programmatically via the Apify API.

Can gender be missing?

Yes. If the actor can’t identify gender from the public profile page, it sets the value to "UNKNOWN".

Is there a run-level summary I can consume via API?

Yes. The actor saves a structured summary to the key-value store under the key OUTPUT, including totals and per-profile statistics you can retrieve via the Apify API.

Closing CTA / Final thoughts

Facebook Followers Scraper is built to turn public Facebook follower lists into structured, analysis-ready datasets. It delivers reliable collection with proxy fallback, pagination, and incremental dataset writes. Marketers, analysts, and researchers can export clean JSON/CSV, while developers can wire it into APIs and automated pipelines on Apify. Start extracting smarter follower insights today and automate your audience analysis end-to-end.