# Yellow Pages Email Scraper (`scraper-engine/yellow-pages-email-scraper`) Actor

Yellow Pages Email Scraper extracts publicly available business email addresses from Yellow Pages listings. Build targeted lead lists by industry or location. Ideal for sales teams, marketers, and agencies running local outreach campaigns.

- **URL**: https://apify.com/scraper-engine/yellow-pages-email-scraper.md
- **Developed by:** [Scraper Engine](https://apify.com/scraper-engine) (community)
- **Categories:** Automation, E-commerce, Lead generation
- **Stats:** 6 total users, 1 monthly users, 100.0% runs succeeded, 0 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/actors/running/actors-in-store.md#pay-per-event

## 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

### **Yellow Pages** Email Scraper 📱

The **Yellow Pages** Email Scraper is capable of **extract**ing a wide range of **data** from Yellow Pages business listings. This includes essential **contact** information such as email addresses, listing titles, and page snippets.

It also captures the direct listing URL for every match. With this tool, users can gather structured and actionable **data** for various business purposes.

The scraper ensures that all **extract**ed **data** is accurate, relevant, and up-to-date. This makes it an ideal solution for businesses looking to streamline their **data** collection processes.

Whether you're building a **contact** **data**base or conducting market research, the **Yellow Pages** Email Scraper provides comprehensive **data** **extract**ion capabilities.

Yellow Pages Email Scraper is a powerful tool designed to extract email addresses and contact information from Yellow Pages business listings efficiently. It helps businesses streamline their lead generation process and connect with local businesses listed on Yellow Pages.

With Yellow Pages email extraction tools, you can gather valuable contact information for marketing, outreach, or research purposes. This scraper saves time and effort by automating the data collection process.

Scraping Yellow Pages emails can provide insights into local business listings, allowing businesses to build targeted campaigns. The Yellow Pages Email Scraper ensures accurate and up-to-date data extraction for optimal results.

### Support and feedback

- **Bug reports**: Open a ticket in the repository Issues section
- **Custom features**: Contact our enterprise support team
  *Email: dev.scraperengine@gmail.com*

### Extractable Data Table 📊

Each result row contains the following fields:

| Data Type | Description |
| --- | --- |
| network | Source platform (e.g. yellowpages.com). |
| keyword | The keyword that produced this result. |
| title | Title of the result (usually the business listing name). |
| description | Snippet text from the result, which may contain contact info. |
| url | Direct URL to the Yellow Pages business listing page. |
| email | Publicly available email address extracted from the result. |

### Key Features of **Yellow Pages** Email Scraper

Here are the **standout features** that make the **Yellow Pages** Email Scraper a **top-tier tool** for **marketers**, **agencies**, and **researchers**:

- ⭐ Automates the extraction of email addresses from **Yellow Pages** business listings
- ⭐ Supports keyword and location targeting to focus on specific industries or areas
- ⭐ Provides accurate and up-to-date information for reliable data analysis
- ⭐ User-friendly interface with customizable scraping options
- ⭐ **Fast** and efficient data scraping to save time and resources
- ⭐ Ensures compliance with ethical scraping practices and data privacy standards
- ⭐ Offers export options in multiple formats such as CSV or JSON
- ⭐ Compatible with various operating systems and devices
- ⭐ Includes error-handling mechanisms for uninterrupted scraping
- ⭐ **Regular** updates to maintain compatibility with **Yellow Pages**' platform changes
- ⭐ **Secure** and encrypted data handling to protect user privacy
- ⭐ 247 customer support for troubleshooting and assistance

### How to use **Yellow Pages** Email Scraper 🚀

Follow this **simple, step-by-step guide** to start extracting **Yellow Pages** emails today:

1. ✅ Open the **Yellow Pages** Email Scraper on the Apify platform
2. ✅ **Sign in** with your Apify account
3. ✅ Enter the search parameters such as keywords or location
4. ✅ **Configure** the email domain filter and maximum emails per keyword
5. ✅ **Start** the scraper and let it process the **Yellow Pages** listings based on your input
6. ✅ Monitor the scraping progress through the run log and dataset preview
7. ✅ Once completed review the extracted data for accuracy and completeness
8. ✅ **Export** the data in your preferred format such as CSV or JSON
9. ✅ Use the extracted data for lead generation marketing or research purposes
10. ✅ Regularly rerun the scraper to keep up with **Yellow Pages**' latest listings
11. ✅ Refer to the input parameters table for advanced customization options
12. ✅ Contact customer support if you encounter any issues during the scraping process

### Use Cases 🎯

Lead Generation
🎯 Extract email addresses of local businesses for targeted outreach
🎯 Build a comprehensive contact database for marketing campaigns

Market Research
🎯 **Analyze** local business listings to understand market trends
🎯 Gather result titles and snippets for competitive analysis

Business Development
🎯 **Identify** potential partners or collaborators in a specific industry
🎯 **Use** contact information to establish connections with local business owners

Data Analysis
🎯 **Collect** structured data for in-depth analysis and reporting
🎯 Leverage extracted information to make informed business decisions

### Why choose us? 💎

Our **Yellow Pages** Email Scraper stands out for its efficiency, accuracy, and **user-friendly** design. It is tailored to meet the diverse needs of businesses, from lead generation to market research.

By using this tool, you can save time and resources while ensuring **reliable** data extraction. We prioritize data accuracy, ensuring that the information you gather is up-to-date and actionable.

Our scraper is built with compliance in mind, adhering to ethical data scraping practices. With **regular** updates, we ensure compatibility with **Yellow Pages**' platform changes, so you always have access to the latest features.

Whether you're a small business or a large enterprise, our tool scales to meet your requirements. Our dedicated customer support team is available 24/7 to assist you with any issues or questions.

Choose our **Yellow Pages** Email Scraper for a seamless and efficient data extraction experience.

### **Yellow Pages** Email Scraper Scalability 📈

The **Yellow Pages** Email Scraper is designed to handle data extraction tasks of any scale. Whether you need to scrape a few listings or thousands, our tool adapts to your requirements.

It features **advanced** algorithms that ensure fast and **efficient** data processing, even for large datasets. The scraper's performance remains consistent, regardless of the volume of data being extracted.

With **customizable** settings, you can tailor the scraping process to focus on specific keywords or locations. This flexibility makes it suitable for businesses of all sizes, from startups to large enterprises.

Our tool is also optimized for resource efficiency, minimizing the impact on your device's performance. Experience **seamless** scalability with the **Yellow Pages** Email Scraper, designed to grow with your business needs.

### **Yellow Pages** Email Scraper Legal Guidelines ⚖️

**Yes**—scraping **Yellow Pages** is **legal** as long as you follow **ethical** and **compliant** practices. The **Yellow Pages** Email Scraper extracts only **publicly available** information from **public** **Yellow Pages** business listings, making it **safe** and **compliant** for **research**, **marketing**, and **analysis**.

#### Legal & Ethical Guidelines

⚖️ **Ensure** compliance with **Yellow Pages**' terms of service before using the scraper
⚖️ **Use** the tool only for lawful and ethical purposes such as lead generation or research
⚖️ **Do not** use the scraper to collect sensitive or personal information without consent
⚖️ **Avoid** sharing or selling extracted data to third parties without proper authorization
⚖️ Respect data privacy regulations such as GDPR and CCPA during the scraping process
⚖️ Limit scraping frequency to prevent overloading **Yellow Pages**' servers
⚖️ Regularly review and update your scraping practices to adhere to legal standards
⚖️ Consult with legal professionals if you are unsure about the compliance of your scraping activities

### Input Parameters 🧩

📦 Example Input (JSON)

```json
{
  "keywords": ["plumber", "restaurant"],
  "platform": "Yellowpages",
  "location": "Chicago",
  "emailDomains": ["@gmail.com", "@outlook.com"],
  "maxEmails": 10,
  "engine": "legacy",
  "proxyConfiguration": { "useApifyProxy": false }
}
```

### Input Table

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| keywords | array | ✅ Yes | Keywords used to find relevant Yellow Pages business listings. One or more. |
| platform | string | No | Platform to scrape. Currently `Yellowpages`. |
| location | string | No | Optional location filter (e.g. `Chicago`). Empty = nationwide. |
| emailDomains | array | No | Keep only emails from these domains (e.g. `@gmail.com`). Custom/business domains supported. Empty = all domains. |
| maxEmails | integer | No | Max emails to collect per keyword (default `10`, range 1–100000). |
| engine | string | No | Processing engine. Currently `legacy`. |
| proxyConfiguration | object | No | Proxy settings. Empty = the actor auto-selects the best proxy (recommended). |

> ℹ️ Emails are sourced from publicly available information only. Yield depends on how many listings publicly expose a contact email. Business listings frequently publish their own company domain email (e.g. `@thebusinessname.com`) rather than a personal webmail address — broadening or removing the `emailDomains` filter often surfaces more results. Broaden `keywords`/`emailDomains` and raise `maxEmails` for more results.

### Output Format 📤

📝 Example Output (JSON)

```json
[
  {
    "network": "yellowpages.com",
    "keyword": "plumber",
    "title": "Ace Plumbing & Heating - Chicago, IL",
    "description": "Licensed plumber serving Chicago since 1998 · Contact: info@aceplumbingchicago.com",
    "url": "https://www.yellowpages.com/chicago-il/mip/ace-plumbing-heating-123456789",
    "email": "info@aceplumbingchicago.com"
  }
]
```

### Output Table

| Data Type | Description |
| --- | --- |
| network | Source platform (yellowpages.com) |
| keyword | Keyword that triggered the result |
| title | Result title (usually the business listing name) |
| description | Public snippet, may contain contact info |
| url | Direct Yellow Pages business listing link |
| email | Extracted email address |

### FAQ ❓

#### What is the Yellow Pages **Email Scraper**?

The Yellow Pages Email Scraper is a tool designed to extract email addresses and other data from Yellow Pages business listings for lead generation and research purposes.

#### Is the Yellow Pages **Email Scraper** easy to use?

**Yes**, the Yellow Pages Email Scraper features a **user-friendly** interface and straightforward setup process.

#### What data can I **extract** using the Yellow Pages **Email Scraper**?

You can extract publicly available email addresses along with the result title, snippet, and page URL for each match.

#### Is the Yellow Pages **Email Scraper** compliant with data privacy laws?

**Yes**, the scraper is designed to adhere to data privacy regulations such as GDPR and CCPA.

#### Can I customize the data I want to **extract**?

**Yes**, you can configure the scraper to focus on specific keywords or locations.

#### What formats can I **export** the data in?

The extracted data can be exported in formats such as **CSV** or **JSON**.

#### Does the scraper work on all devices?

**Yes**, the Yellow Pages Email Scraper runs on the Apify platform and is accessible from any device with a browser.

#### How often is the scraper updated?

The scraper is regularly updated to maintain compatibility with Yellow Pages' platform changes.

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

**Yes**, our customer support team is available 24/7 to assist with any issues or questions.

#### Can I use the scraper for **large-scale** data **extract**ion?

**Yes**, the Yellow Pages Email Scraper is designed to handle data extraction tasks of any scale.

#### Is the scraper **secure**?

**Yes**, the scraper uses **secure** and encrypted data handling to protect user privacy.

#### How do I get started with the Yellow Pages **Email Scraper**?

Open the actor on Apify, configure your keywords and settings, and start extracting data from Yellow Pages business listings.

#### Are there any restrictions on using the scraper?

**Yes**, ensure **compliance** with Yellow Pages' terms of service and use the scraper only for lawful purposes.

#### Can I scrape multiple locations at once?

**Yes**, you can run the scraper multiple times with different location filters, or leave location empty to search nationwide.

#### What should I do if I encounter an issue?

Contact our 24/7 customer support team for assistance with any issues or questions.

# Actor input Schema

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

🎯 The words that power your search! Add one or more keywords (e.g. \['plumber', 'restaurant', 'dentist']) and the actor finds public Yellow Pages business listing pages matching them, then 📧 extracts any email addresses it finds. 💡 Tip: more specific keywords = more targeted leads.

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

📱 The site to scrape. Currently locked to Yellow Pages — more platforms coming soon! 🚀

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

🗺️ Optional geo-targeting! Add a city or region (e.g. 'Chicago', 'Austin TX', 'Miami') to narrow results to pages mentioning that place. ✨ Leave empty to search nationwide 🌍.

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

🎛️ Keep only emails from the domains you care about — type as many as you like! ✍️ Popular picks: 📮 @gmail.com · 📨 @outlook.com · 💌 @hotmail.com · 💜 @yahoo.com · ☁️ @icloud.com · 📬 @aol.com · 🔒 @protonmail.com · 📥 @live.com · 📧 @gmx.com · 🟡 @yandex.com · 📗 @zoho.com. 🏢 Custom/business domains work too — e.g. @yourcompany.com (many business listings publish their own company domain rather than a personal webmail address). 🕳️ Leave empty to collect emails from ALL domains. 💡 Adding a domain also sharpens the search 🎯.

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

🎚️ How many emails to collect per keyword before moving on. ⚡ Higher = more leads but longer runs. Default is 10 ✅ (range 1 – 100,000).

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

🔧 The processing engine. Currently 'legacy' 🛡️ — a reliable, battle-tested extraction pipeline. More engines on the roadmap! 🚧

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

🌐 Control how the actor connects to the internet. 🆓 Leave it empty and the actor auto-selects the best proxy for reliable results. 🔄 On any failed response it rotates the connection and retries up to 3× automatically. 🧠 Advanced users can plug in custom proxies here.

## Actor input object example

```json
{
  "keywords": [
    "plumber"
  ],
  "platform": "Yellowpages",
  "location": "",
  "emailDomains": [
    "@gmail.com"
  ],
  "maxEmails": 10,
  "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": [
        "plumber"
    ],
    "emailDomains": [
        "@gmail.com"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

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

# Run the Actor and wait for it to finish
run = client.actor("scraper-engine/yellow-pages-email-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "plumber"
  ],
  "emailDomains": [
    "@gmail.com"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scraper-engine/yellow-pages-email-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper-engine/yellow-pages-email-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Ud2teb1UNN6eo6mBo/builds/SXGzgO6jYvaeKjkml/openapi.json