Facebook Profile & Page Scraper

Extract comprehensive Facebook profile and page data with a single click. Enter usernames or URLs and get structured data including followers, likes, contact information, and engagement metrics.

Features

• Flexible Input - Accepts usernames, full URLs, or mixed formats
• Complete Profile Data - Name, bio, followers, likes, categories, verification status
• Contact Information - Email, phone, website, address when available
• Visual Assets - Profile pictures and cover photos
• Engagement Metrics - Calculated engagement rates and audience size categories
• Anti-Detection - Session management, proxy rotation, rate limiting

Quick Start

Step 1: Enter Profiles

Paste Facebook usernames or URLs (one per line):

nasaearth
ChrisBrecheensWritingAboutWriting
https://www.facebook.com/UNclimatechange
facebook.com/some-company

Step 2: Run the Actor

Click Start and wait for extraction to complete.

Step 3: Download Results

Get your data as JSON, CSV, or Excel from the Storage tab.

Input Options

Parameter	Type	Default	Description
profiles	String	(required)	Facebook usernames or URLs, one per line
mode	String	fast	Extraction strategy: Fast (recommended), Balanced, or Deep
proxyType	String	BUYPROXIES94952	Proxy type: Datacenter, Residential, or Static US
maxConcurrency	Integer	2	Parallel pages (1-5)
maxRequestsPerMinute	Integer	15	Rate limit (5-30)
maxProfiles	Integer	10	Max profiles per run (cost control)
maxRuntimePerProfileSecs	Integer	25	Browser fallback runtime budget per profile
requireAuthenticatedData	Boolean	false	Skip HTTP-first optimization for richer authenticated extraction
cookies	String	(optional)	Facebook session cookies for authenticated scraping

Supported Input Formats

All of these formats work:

Avoid non-profile Facebook paths (for example: `/events`, `/reel`, `/watch`, `/groups`).
These URLs are now skipped automatically to prevent wasted runtime and proxy spend.

## Extraction Modes

- **Fast (Recommended):** HTTP-first extraction with limited browser fallback. Best profitability.
- **Balanced:** HTTP-first plus more browser anti-block handling and popup dismissal.
- **Deep:** Browser-focused extraction for maximum completeness at higher cost.

The Actor now defaults to Fast mode to keep runtime and proxy usage low.
nasaearth
NASA Earth
https://www.facebook.com/nasaearth
facebook.com/nasaearth
www.facebook.com/nasaearth/

Output

Sample Output

{
  "inputUrl": "https://www.facebook.com/nasaearth",
  "scrapedUrl": "https://www.facebook.com/nasaearth",
  "profileType": "page",
  "name": "NASA Earth",
  "username": "nasaearth",
  "facebookId": "123456789",
  "verified": true,
  "followers": 10921894,
  "likes": 10505363,
  "about": "Explore and learn more about our home planet.",
  "categories": ["Science Website"],
  "profilePicture": "https://scontent.xx.fbcdn.net/...",
  "coverPhoto": "https://scontent.xx.fbcdn.net/...",
  "email": "contact@nasa.gov",
  "website": "science.nasa.gov/earth",
  "engagementRatio": "0.962",
  "audienceSize": "Large (1M+)",
  "isComplete": true,
  "scrapedAt": "2026-01-26T12:30:45.123Z"
}

Output Fields

Field	Type	Description
inputUrl	String	Original URL/username provided
scrapedUrl	String	Final URL after redirects
profileType	String	page, profile, or unknown
name	String	Display name
username	String	Facebook username/handle
facebookId	String	Numeric Facebook ID
verified	Boolean	Official verification status
followers	Integer	Number of followers
likes	Integer	Number of page likes
about	String	Bio/description
categories	Array	Page categories
profilePicture	String	Profile image URL
coverPhoto	String	Cover image URL
email	String	Contact email (if available)
phone	String	Contact phone (if available)
website	String	Website URL (if available)
address	String	Physical address (if available)
engagementRatio	String	Likes-to-followers ratio
audienceSize	String	Size category (Micro/Small/Medium/Large)
extractionStage	String	http or browser stage used to produce the result
extractionModeUsed	String	Mode used for extraction (fast, balanced, deep)
durationMs	Integer	Approximate extraction time for this profile
isComplete	Boolean	Whether all data was extracted
wasBlocked	Boolean	Whether extraction was blocked

Authentication (Optional)

For higher success rates, provide your Facebook session cookies. Cookies now take effect in all modes (including Fast) — they are sent on both the HTTP-first request and the browser fallback, so you no longer need to switch modes or toggles for them to work.

1. Log into Facebook in your browser
2. Install the Cookie-Editor browser extension
3. Click the extension icon on facebook.com
4. Click Export > Export as JSON
5. Paste the JSON array in the cookies field

Cookies expire. Facebook rotates the xs session cookie frequently. Make sure your export includes both c_user and xs; if a run is still blocked while authenticated, the log will warn that your cookies are likely expired — re-export fresh ones from a logged-in session.

Cookie Format

[
  {"name": "c_user", "value": "YOUR_USER_ID", "domain": ".facebook.com"},
  {"name": "xs", "value": "YOUR_SESSION", "domain": ".facebook.com"}
]

Proxy Options

Option	Description	Best For
BUYPROXIES94952	Datacenter proxies (default)	Cost-effective general scraping
RESIDENTIAL	Residential proxies	Higher success rate, premium cost
StaticUS3	Static US IPs	Consistent identity across requests

Residential fallback (on by default): Facebook heavily blocks datacenter IPs. When a profile is blocked on the default proxy, it is automatically retried on residential IPs, which usually clear the login wall. You only pay the premium residential rate for the profiles that were actually blocked. Set enableResidentialFallback to false to cap cost at the datacenter rate.

Use Cases

Marketing & Social Media

• Competitor analysis and benchmarking
• Influencer research and discovery
• Campaign planning and audience research
• Brand monitoring

Business Intelligence

• Lead generation and prospecting
• Market research
• Partnership research
• Content strategy analysis

Research & Analysis

• Academic social media research
• Market trend analysis
• Communication studies

Technical Details

Anti-Detection Measures

• Session Pool - Rotates sessions to avoid fingerprinting
• Proxy Rotation - Distributes requests across IPs
• Rate Limiting - Configurable request throttling
• Random Delays - Human-like timing between requests
• Login Popup Dismissal - Handles Facebook modals automatically

Limitations

• Public data only - Cannot access private profiles
• Rate limits - Facebook may block after many requests
• Login walls - Some pages trigger login requirements
• Dynamic content - Some data may not be available on all pages

Best Practices

1. Start with Fast mode for best margin and scale
2. Keep concurrency low (1-2) to avoid blocks
3. Use residential proxies only for difficult pages
4. Provide cookies for authenticated access when needed
5. Space out runs to avoid IP blocks

Cost Estimation

• Datacenter proxy: ~$0.25 per 1000 requests
• Residential proxy: ~$12.50 per 1000 requests
• Compute: ~$0.10 per 100 profiles

Error Handling

The scraper handles common issues gracefully:

• Blocked profiles - Marked with wasBlocked: true
• Private profiles - Returns available public data
• Invalid URLs - Skipped with error message
• Timeouts - Automatic retry with new session

Support

For issues or feature requests, contact the author or open an issue on the Actor's page.