# Facebook Page Lead Scraper (`simpleapi/facebook-page-lead-scraper`) Actor

Facebook Page Lead Scraper extracts lead data from Facebook business pages. Collect page names, profile links, categories, follower counts, contact details, and engagement metrics to discover businesses, analyze competitors, or build targeted outreach and marketing lists. 📊📘

- **URL**: https://apify.com/simpleapi/facebook-page-lead-scraper.md
- **Developed by:** [SimpleAPI](https://apify.com/simpleapi) (community)
- **Categories:** Lead generation, Social media, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.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** Lead Scraper 📱

The **Facebook** Page Lead Scraper allows users to **extract** a variety of **data** from **Facebook** pages and profiles. It focuses on gathering publicly available **contact** information, such as lead addresses, to support business outreach and marketing strategies.

This tool can retrieve **data** from **Facebook** business pages, profiles, and other accessible sections where **contact** information is shared. By automating the **data** **extract**ion process, it eliminates the need for manual searching and copying of information.

Users can **extract** **data** in bulk, making it ideal for large-scale lead generation campaigns. The **extract**ed **data** is presented in a structured format, ensuring easy integration into your existing workflows.

With its advanced algorithms, the scraper ensures that the **data** collected is accurate and up-to-date. It is designed to comply with legal and ethical guidelines, ensuring responsible use of the **extract**ed information.

Facebook Page Lead Scraper is a powerful tool designed to extract contact leads from Facebook pages and profiles efficiently. It simplifies the process of gathering valuable contact information for marketing, lead generation, and business outreach.

With the increasing importance of direct communication, having access to valid lead addresses from Facebook pages can significantly boost your marketing efforts. This tool ensures accurate and reliable data extraction from public Facebook profiles and business pages.

Our Facebook lead scraping tool is user-friendly and requires minimal technical expertise, making it accessible for businesses of all sizes. It automates the process of finding and extracting leads, saving you time and effort.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Lead: dev.scraperengine@gmail.com *
### Extractable Data Table 📊
| Data Type | Description |
| --- | --- |
| Lead Addresses | Extracts publicly available lead addresses from Facebook pages and profiles. |
| Page Names | Captures the names of Facebook pages where leads are extracted. |
| Profile Names | Retrieves the names of individual profiles associated with extracted leads. |
| Page URLs | Provides the URLs of Facebook pages for reference and verification. |
| Profile URLs | Includes the URLs of individual profiles linked to the extracted leads. |
| Business Categories | Identifies the business category of Facebook pages, if available. |
| Location Information | Extracts location details shared on pages or profiles, if public. |
| Phone Numbers | Captures publicly displayed phone numbers, if available. |

### Key Features of **Facebook** Lead Scraper

Here are the **standout features** that make the **Facebook** Lead Scraper a **top-tier tool** for **marketers**, **agencies**, and **researchers**:

- ⭐ Extracts lead addresses from **Facebook** pages and profiles with high accuracy
- ⭐ Supports bulk data extraction for large-scale lead generation campaigns
- ⭐ User-friendly interface requiring minimal technical expertise to operate
- ⭐ Automates the process of finding and extracting leads saving time and effort
- ⭐ Provides structured data output for seamless integration into workflows
- ⭐ Ensures compliance with ethical and legal data collection standards
- ⭐ Offers advanced filtering options to refine and target specific data sets
- ⭐ Compatible with various operating systems and devices for maximum flexibility
- ⭐ **Regular** updates to ensure compatibility with **Facebook**s platform changes
- ⭐ Includes robust customer support for troubleshooting and assistance

### How to use **Facebook** Lead Scraper 🚀

Follow this **simple, step-by-step guide** to start extracting **Facebook** leads today:

1. ✅ Log in to your **Facebook** account and ensure you have access to the pages or profiles you want to scrape
2. ✅ Download and install the **Facebook** Page Lead Scraper software on your device
3. ✅ Open the tool and enter the URL of the **Facebook** page or profile you wish to scrape
4. ✅ **Select** the specific data types you want to extract such as leads or page names
5. ✅ **Configure** any additional settings such as filters or output formats as needed
6. ✅ Click the **Start** button to initiate the scraping process
7. ✅ Wait for the tool to complete the extraction and display the collected data
8. ✅ **Export** the extracted data to your preferred format such as CSV or Excel
9. ✅ **Review** the data for accuracy and integrate it into your existing workflow
10. ✅ Repeat the process for additional pages or profiles as required

### Use Cases 🎯

Lead Generation
🎯 Extract leads from **Facebook** business pages to build targeted lead lists
🎯 **Identify** potential clients or partners by gathering contact information from relevant profiles

Marketing Campaigns
🎯 **Use** the extracted leads to send promotional offers or newsletters
🎯 Expand your reach by targeting businesses or individuals in specific industries

Business Networking
🎯 Connect with professionals by extracting contact details from their profiles
🎯 **Identify** potential collaborators or investors through **Facebook** pages

Market Research
🎯 **Analyze** business categories and locations of **Facebook** pages for research purposes
🎯 Gather data to understand market trends and customer preferences

### Why choose us? 💎

Our **Facebook** Page Lead Scraper stands out for its efficiency, accuracy, and **user-friendly** design. It is built to cater to businesses of all sizes, from startups to large enterprises, ensuring that everyone can benefit from its powerful features.

The tool is equipped with **advanced** algorithms that ensure data accuracy and relevance, helping you make informed business decisions. We prioritize compliance with legal and ethical guidelines, ensuring that your data collection practices remain responsible and secure.

Our scraper is **regular**ly updated to adapt to changes in **Facebook**'s platform, ensuring uninterrupted functionality. With robust customer support and detailed documentation, we ensure a seamless user experience.

Whether you're looking to generate leads, conduct market research, or expand your business network, our tool is designed to meet your needs. Choose us for a **reliable**, efficient, and compliant solution to your **Facebook** lead scraping requirements.

### **Facebook** Lead Scraper Scalability 📈

The **Facebook** Page Lead Scraper is designed to handle projects of all sizes, making it suitable for both small businesses and large enterprises. It supports bulk data extraction, allowing you to scrape leads from multiple **Facebook** pages or profiles simultaneously.

The tool's **advanced** algorithms ensure that it can process large amounts of data without compromising on speed or accuracy. Whether you're working on a small-scale campaign or a **large-scale** lead generation project, our scraper can adapt to your needs.

It provides flexible options for configuring filters and output formats, ensuring that the extracted data aligns with your specific requirements. With its scalable infrastructure, the tool can grow with your business, accommodating increasing data extraction demands over time.

Choose our scraper for a solution that combines efficiency, flexibility, and scalability.

### **Facebook** Lead Scraper Legal Guidelines ⚖️

**Yes**—scraping **Facebook** is **legal** as long as you follow **ethical** and **compliant** practices. The **Facebook** Lead Scraper extracts only **publicly available** information from **public** **Facebook** profiles, making it **safe** and **compliant** for **research**, **marketing**, and **analysis**.

#### Legal & Ethical Guidelines
⚖️ **Ensure** compliance with **Facebook**s terms of service when using the scraper
⚖️ **Only** extract data that is publicly available and avoid accessing private information
⚖️ **Do not** use the extracted data for spamming or unethical marketing practices
⚖️ **Obtain** consent from individuals before using their contact information for outreach
⚖️ **Use** the tool responsibly and avoid overloading **Facebook**s servers with excessive requests
⚖️ Regularly review and adhere to data protection laws and regulations in your region
⚖️ **Avoid** sharing or selling the extracted data to third parties without proper authorization
⚖️ **Use** the scraper for legitimate business purposes and not for malicious activities

### Input Parameters 🧩
📦 Example Input (JSON)
```json
{
  "keywords": ["Facebook Page Lead Scraper"],
  "country": "Global",
  "maxLeadNumbers": 20,
  "platform": "Facebook",
  "engine": "legacy"
}
````

### Input Table

| Data Type | Description |
| --- | --- |
| keywords | Keywords to find relevant profiles |
| country | Country setting (Global) |
| maxLeadNumbers | Maximum leads to collect (default 20) |
| platform | Platform to scrape (Facebook) |
| engine | Engine type (legacy) |
| proxyConfiguration | Optional proxy settings |

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "network": "Facebook",
    "keyword": "Facebook Page Lead Scraper",
    "title": "Google's Single-Benefit Marketing Strategy for Chrome ...",
    "description": "✓For years, once we created a Gmail account, we couldn't change the username (the part before @ gmail.com ). ... Grand Rapids Marketing Co. Read more",
    "url": "https://www.linkedin.com/posts/phill-agnew_heres-how-google-marketed-chrome-browser-activity-7404878510214914048-dLxI",
    "lead": "before@gmail.com"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| network | Identifies Facebook as the source |
| keyword | Keyword that triggered the result (Facebook Page Lead Scraper) |
| title | Profile title or username |
| description | Public bio snippet with contact info |
| url | Direct Facebook profile link |
| lead | Extracted lead address |

### FAQ ❓

#### What is the Facebook Page **Lead Scraper**?

It is a tool designed to extract **publicly available** lead addresses from Facebook pages and profiles.

#### Is the Facebook lead scraping tool easy to use?

**Yes**, it features a **user-friendly** interface that requires minimal technical expertise.

#### Can I scrape leads from multiple Facebook pages at once?

**Yes**, the tool supports bulk data extraction for efficient lead generation.

#### Is the **extract**ed data accurate?

The tool uses advanced algorithms to ensure data accuracy and relevance.

#### Does the tool comply with Facebook's terms of service?

**Yes**, it is designed to extract only **publicly available** data in **compliance** with Facebook's guidelines.

#### What formats can I **export** the **extract**ed data to?

You can export the data to formats like **CSV** or Excel for easy integration.

#### Can I use the tool for personal purposes?

**Yes**, as long as you adhere to legal and ethical guidelines and use it responsibly.

#### Does the tool support filtering options?

**Yes**, you can configure filters to refine the data extraction process.

#### Is **customer support** available?

**Yes**, we provide robust customer support to assist with any issues or questions.

#### Can I scrape **private** information using this tool?

**No**, the tool only extracts **publicly available** information to ensure **compliance** with privacy laws.

#### Is the scraper compatible with all operating systems?

**Yes**, it is compatible with various operating systems and devices.

#### How often is the tool updated?

The tool is regularly updated to adapt to changes in Facebook's platform.

#### Can I use the tool for market research?

**Yes**, it is ideal for gathering data to analyze market trends and customer preferences.

#### What happens if Facebook changes its platform?

Our team ensures **regular updates** to maintain compatibility with any changes.

#### Is the tool scalable for large projects?

**Yes**, it is designed to handle projects of all sizes, from small campaigns to large-scale extractions.

### What are other Facebook scraping tools?

If you want to scrape specific Facebook data, you can use any of the dedicated scrapers below for faster and more targeted results.

| Scraper Name | Scraper Name |
|---|---|
| [Facebook Ads Library Scraper](https://apify.com/simpleapi/facebook-ads-library-scraper) | [Facebook Page Email Scraper](https://apify.com/simpleapi/facebook-page-email-scraper) |
| [Facebook B2b Email Scraper](https://apify.com/simpleapi/facebook-b2b-email-scraper) | [Facebook Page Phone Number Scraper](https://apify.com/simpleapi/facebook-page-phone-number-scraper) |
| [Facebook B2b Lead Scraper](https://apify.com/simpleapi/facebook-b2b-lead-scraper) | [Facebook Page Posts Scraper](https://apify.com/simpleapi/facebook-page-posts-scraper) |
| [Facebook B2b Phone Number Scraper](https://apify.com/simpleapi/facebook-b2b-phone-number-scraper) | [Facebook Page Scraper](https://apify.com/simpleapi/facebook-page-scraper) |
| [Facebook Comments Scraper](https://apify.com/simpleapi/facebook-comments-scraper) | [Facebook Pages Scraper](https://apify.com/simpleapi/facebook-pages-scraper) |
| [Facebook Email Scraper](https://apify.com/simpleapi/facebook-email-scraper) | [Facebook Phone Number Scraper](https://apify.com/simpleapi/facebook-phone-number-scraper) |
| [Facebook Event Search Scraper](https://apify.com/simpleapi/facebook-event-search-scraper) | [Facebook Photos Scraper](https://apify.com/simpleapi/facebook-photos-scraper) |
| [Facebook Events Scraper](https://apify.com/simpleapi/facebook-events-scraper) | [Facebook Posts Scraper](https://apify.com/simpleapi/facebook-posts-scraper) |
| [Facebook Followers & Following Scraper](https://apify.com/simpleapi/facebook-followers-following-scraper) | [Facebook Posts Search Scraper](https://apify.com/simpleapi/facebook-posts-search-scraper) |
| [Facebook Followers Scraper](https://apify.com/simpleapi/facebook-followers-scraper) | [Facebook Profile Email Scraper](https://apify.com/simpleapi/facebook-profile-email-scraper) |
| [Facebook Group Member Scraper](https://apify.com/simpleapi/facebook-group-member-scraper) | [Facebook Profile Lead Scraper](https://apify.com/simpleapi/facebook-profile-lead-scraper) |
| [Facebook Group Post Scraper](https://apify.com/simpleapi/facebook-group-post-scraper) | [Facebook Profile Phone Number Scraper](https://apify.com/simpleapi/facebook-profile-phone-number-scraper) |
| [Facebook Group Posts And Details Scraper](https://apify.com/simpleapi/facebook-group-posts-and-details-scraper) | [Facebook Reels Scraper](https://apify.com/simpleapi/facebook-reels-scraper) |
| [Facebook Group Profile Scraper](https://apify.com/simpleapi/facebook-group-profile-scraper) | [Facebook Reviews Scraper](https://apify.com/simpleapi/facebook-reviews-scraper) |
| [Facebook Groups Posts Scraper](https://apify.com/simpleapi/facebook-groups-posts-scraper) | [Facebook Search Scraper](https://apify.com/simpleapi/facebook-search-scraper) |
| [Facebook Groups Scraper](https://apify.com/simpleapi/Facebook-Groups-Scraper) | [Facebook Url To Id Scraper](https://apify.com/simpleapi/facebook-url-to-id-scraper) |
| [Facebook Groups Search Scraper](https://apify.com/simpleapi/facebook-groups-search-scraper) | [Facebook User Search Scraper](https://apify.com/simpleapi/Facebook-User-Search-Scraper) |
| [Facebook Lead Scraper](https://apify.com/simpleapi/facebook-lead-scraper) | [Facebook Video Search Scraper](https://apify.com/simpleapi/facebook-video-search-scraper) |
| [Facebook Likes and Reactions Scraper](https://apify.com/simpleapi/facebook-likes-reactions-scraper) | [Facebook Video Transcript Extractor](https://apify.com/simpleapi/facebook-video-transcript-extractor) |
| [Facebook Marketplace Scraper](https://apify.com/simpleapi/facebook-marketplace-scraper) | [Facebook Videos Scraper](https://apify.com/simpleapi/facebook-videos-scraper) |

# Actor input Schema

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

List of keywords to search for on Facebook (e.g., \['marketing', 'founder', 'business']). The actor will search Google for Facebook profiles/posts containing these keywords and extract email addresses.

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

Select platform.

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

Optional: Add location to search query (e.g., 'London', 'New York'). Leave empty to search globally.

## `emailDomains` (type: `array`):

Optional: Filter results to only include emails from specific domains (e.g., \['@gmail.com', '@outlook.com']). Leave empty to collect all email domains.

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

Maximum number of emails to collect per keyword (default: 20).

## `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`):

Choose which proxies to use. By default, no proxy is used. If Google rejects or blocks the request, the actor will automatically fallback to datacenter proxy, then residential proxy with 3 retries.

## Actor input object example

```json
{
  "keywords": [
    "marketing"
  ],
  "platform": "Facebook",
  "location": "",
  "emailDomains": [
    "@gmail.com"
  ],
  "maxEmails": 20,
  "engine": "legacy",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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": [
        "marketing"
    ],
    "emailDomains": [
        "@gmail.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("simpleapi/facebook-page-lead-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": ["marketing"],
    "emailDomains": ["@gmail.com"],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("simpleapi/facebook-page-lead-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": [
    "marketing"
  ],
  "emailDomains": [
    "@gmail.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call simpleapi/facebook-page-lead-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Facebook Page Lead Scraper",
        "description": "Facebook Page Lead Scraper extracts lead data from Facebook business pages. Collect page names, profile links, categories, follower counts, contact details, and engagement metrics to discover businesses, analyze competitors, or build targeted outreach and marketing lists. 📊📘",
        "version": "0.1",
        "x-build-id": "d76KAdf3aTAqJUwtB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/simpleapi~facebook-page-lead-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-simpleapi-facebook-page-lead-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/simpleapi~facebook-page-lead-scraper/runs": {
            "post": {
                "operationId": "runs-sync-simpleapi-facebook-page-lead-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/simpleapi~facebook-page-lead-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-simpleapi-facebook-page-lead-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": [
                    "keywords"
                ],
                "properties": {
                    "keywords": {
                        "title": "Keywords",
                        "type": "array",
                        "description": "List of keywords to search for on Facebook (e.g., ['marketing', 'founder', 'business']). The actor will search Google for Facebook profiles/posts containing these keywords and extract email addresses.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "platform": {
                        "title": "Platform",
                        "enum": [
                            "Facebook"
                        ],
                        "type": "string",
                        "description": "Select platform.",
                        "default": "Facebook"
                    },
                    "location": {
                        "title": "Location Filter",
                        "type": "string",
                        "description": "Optional: Add location to search query (e.g., 'London', 'New York'). Leave empty to search globally.",
                        "default": ""
                    },
                    "emailDomains": {
                        "title": "Email Domains Filter",
                        "type": "array",
                        "description": "Optional: Filter results to only include emails from specific domains (e.g., ['@gmail.com', '@outlook.com']). Leave empty to collect all email domains.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxEmails": {
                        "title": "Maximum Emails per Keyword",
                        "minimum": 1,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Maximum number of emails to collect per keyword (default: 20).",
                        "default": 20
                    },
                    "engine": {
                        "title": "Engine",
                        "enum": [
                            "legacy"
                        ],
                        "type": "string",
                        "description": "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.",
                        "default": "legacy"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Choose which proxies to use. By default, no proxy is used. If Google rejects or blocks the request, the actor will automatically fallback to datacenter proxy, then residential proxy with 3 retries."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
