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
proxyType	String	BUYPROXIES94952	Proxy type: Datacenter, Residential, or Static US
maxConcurrency	Integer	2	Parallel pages (1-5)
maxRequestsPerMinute	Integer	15	Rate limit (5-30)
cookies	String	(optional)	Facebook session cookies for authenticated scraping

Supported Input Formats

All of these formats work:

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)
isComplete	Boolean	Whether all data was extracted
wasBlocked	Boolean	Whether extraction was blocked

Authentication (Optional)

For higher success rates, provide your Facebook session cookies:

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

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

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. Keep concurrency low (1-2) to avoid blocks
2. Use residential proxies for difficult pages
3. Provide cookies for authenticated access
4. 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.