# Mass Facebook Email Scraper (`scraper-mind/facebook-email-scraper`) Actor

\[𝗖𝗵𝗲𝗮𝗽𝗲𝘀𝘁 𝗣𝗿𝗶𝗰𝗲] The Facebook Email Scraper efficiently extracts email addresses from Facebook profiles based on custom keywords. Perfect for influencer outreach, marketing, and collaborations. Fast, accurate, and 50% more affordable than competitors. Boost your outreach efforts now.

- **URL**: https://apify.com/scraper-mind/facebook-email-scraper.md
- **Developed by:** [Scraper Mind](https://apify.com/scraper-mind) (community)
- **Categories:** Lead generation, Social media
- **Stats:** 744 total users, 22 monthly users, 100.0% runs succeeded, 21 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Email Scraper - Fast, Accurate & Affordable

The Facebook Email Scraper is a powerful tool for extracting email addresses from Facebook profiles using custom keywords. Whether you're conducting influencer outreach, social media marketing, or researching potential collaborations, this tool is 50% more affordable than competitors, delivering reliable, high-quality results.

### 🌟 Key Features

- 🔍 **Custom Keyword Search**: Target Facebook profiles by searching with specific keywords to reach niche audiences.
- 📧 **Domain-based Email Extraction**: Extract email addresses from specific domains (e.g., @gmail.com, @yahoo.com) for focused email lists.
- 👤 **Complete Profile Information**: Collect profile names, URLs, and related snippets for efficient outreach and marketing.
- 🔗 **Direct Facebook Profile Links**: Gain direct access to Facebook profiles for quicker engagement.
- ⚡ **Fast, Affordable, and Reliable**: Provides fast, accurate results at a fraction of the cost of competitors—50% cheaper!
- 🔄 **Automatic Pagination**: Easily handles large datasets with automatic pagination through search results.
- 📊 **Highly Scalable**: Works without proxies for smaller tasks, and supports Datacenter, Residential, or Special Proxies for large-scale scraping to avoid rate-limiting or blocking.

### 📥 Input

The Actor accepts the following JSON input:

```json
{
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "keyword": "real estate agent",
  "platform": "Facebook",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

- **customDomains (required)** : Specify email domains to filter results (e.g., @gmail.com, @yahoo.com).
- **keyword (required)** : Search keyword related to Facebook profiles (e.g., "real estate agent").
- **platform**: Define the platform as Facebook to ensure focused results.
- **proxyConfiguration (optional)** : For larger datasets, proxies can be used to avoid blocking. Use Datacenter Proxies first, and if needed, switch to Residential or Special Proxies for 100% success.

### 📤 Output

The scraper provides a dataset in JSON format with essential data about each extracted Facebook profile:

```json
[
  {
    "title": "John Smith - Real Estate Agent | Facebook",
    "description": "John Smith | Real Estate Agent | Florida | john.smith@gmail.com",
    "url": "https://www.facebook.com/johnsmith.realestate",
    "email": "john.smith@gmail.com"
  },
  .....
]
```

Each result includes:

- **Title**: Profile title, typically including the user's name and related keywords.
- **Description**: A short snippet from the profile or page, giving context to the result.
- **URL**: Direct link to the Facebook profile or page.
- **Email**: Extracted email address from the profile.

### 💻 How to Use

1. **Enter Keywords and Email Domains**: Input your desired keyword and email domains to filter the search results.
2. **Run the Scraper**: The scraper will perform Facebook searches and extract relevant profiles into your dataset.
3. **Set Up Proxies (optional)** : Use proxies for larger scraping tasks to prevent rate-limiting or blocking.
4. **Download and Use the Data**: Export your data in various formats like JSON, CSV, or Excel for easy use in outreach, analysis, or marketing.

### 💡 Best Use Cases

- 🎯 **Influencer Marketing**: Find influencers' email addresses for marketing campaigns.
- 📣 **Social Media Outreach**: Collect contact information to promote your products or services.
- 🔬 **Market Research**: Analyze Facebook profiles within your target industry or niche.
- 🤝 **Business Collaborations**: Identify potential partners and reach out to them directly.

### 🆘 Support & Feedback

For any issues, bugs, or feature requests, please use the issues section.

📩 For custom solutions or further information, contact us at\
**<scrapermindapi@gmail.com>** – we're here to help!

# Actor input Schema

## `keywords` (type: `array`):

A list of keywords to search for.

## `location` (type: `string`):

Location to filter search results.

## `platform` (type: `string`):

Select platform.

## `customDomains` (type: `array`):

List of custom email domains

## `maxEmails` (type: `integer`):

Maximum number of emails to collect. The scraper will stop once this limit is reached. Setting a higher limit allows for more potential results but doesn't guarantee reaching that number. This helps save costs by controlling scraping time.

## `engine` (type: `string`):

Choose scraping engine. 🚀 Cost Effective (New): Uses residential proxies with async requests for faster, cheaper scraping. 🔧 Legacy: Uses GOOGLE\_SERP proxy with traditional selectors - more reliable but slower and more expensive.

## `proxyConfiguration` (type: `object`):

Configure proxies for this Actor.

## Actor input object example

```json
{
  "keywords": [
    "founder",
    "marketing"
  ],
  "location": "",
  "platform": "Facebook",
  "customDomains": [
    "@gmail.com"
  ],
  "maxEmails": 20,
  "engine": "legacy"
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "founder",
        "marketing"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper-mind/facebook-email-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": [
        "founder",
        "marketing",
    ],
    "location": "",
    "customDomains": ["@gmail.com"],
}

# Run the Actor and wait for it to finish
run = client.actor("scraper-mind/facebook-email-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 '{
  "keywords": [
    "founder",
    "marketing"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com"
  ]
}' |
apify call scraper-mind/facebook-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scraper-mind/facebook-email-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/BZYFV9KlZT0gX13LA/builds/6JhQWZZibcuW0Ej49/openapi.json