# Yellow Pages Email Scraper - Decodes Hidden Emails (`code-beat/yellow-pages-email-scraper-ultra-fast-and-precise`) Actor

📒 Yellow Pages Email Scraper pulls local business emails from bulk keyword searches. 🔓 Decodes written-out addresses, filters by domain, skips duplicates. 🏪 Perfect for SMB lead generation, local SEO agencies & B2B cold email.

- **URL**: https://apify.com/code-beat/yellow-pages-email-scraper-ultra-fast-and-precise.md
- **Developed by:** [Code Beat](https://apify.com/code-beat) (community)
- **Categories:** Lead generation, Automation, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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 🔍

**Yellow Pages Email Scraper** helps you extract emails from Yellow Pages faster than manual prospecting, making Yellow Pages email extractor workflows simpler for marketers, recruiters, and sales pros. Use it to streamline Yellow Pages lead generation, collect publicly available contacts, and build a cleaner business directory email scraper process at scale. 🚀

### 🌟 Key Features of Yellow Pages Email Scraper

| Feature | Benefit |
|---|---|
| ✅ **Targeted Keyword Search** | Uses your keywords to find relevant local business email scraper opportunities quickly. |
| ✅ **Location Filtering** | Narrow results by location so your yellow pages contact scraper effort stays focused. |
| ✅ **Custom Domain Filter** | Improve relevance by collecting emails that match the domains you choose. |
| ✅ **Bulk Lead Collection** | Gather multiple Yellow Pages leads in one run for faster outreach planning. |
| ✅ **Built-In Proxy Support** | Helps keep scraping reliable when working with public web data. |
| ✅ **Real-Time Saving** | Saves results as they are found, which helps prevent data loss during longer runs. |
| ✅ **Resumable Runs** | Continues from saved progress so you can pick up where a previous run left off. |

### 📥 Input — Yellow Pages Email Scraper Parameters

```json
{
  "keywords": [
    "manager",
    "founder"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "maxEmails": 20
}
```

| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| `keywords` | Array | Yes | `["manager", "founder"]` | A list of search terms used to find relevant Yellow Pages results. |
| `location` | String | No | `""` | Optional location filter to narrow the results by area. |
| `customDomains` | Array | No | `["@gmail.com", "@yahoo.com"]` | Email domains to look for while collecting contacts. |
| `maxEmails` | Integer | No | `20` | Maximum number of emails to collect before the run stops. |

### 📤 Output — What Yellow Pages Email Scraper Returns

The actor saves each result as a JSON record in your Apify dataset. 📦

```json
{
  "keyword": "founder",
  "title": "Green Leaf Marketing",
  "description": "Digital marketing agency serving small businesses in Austin, TX. Contact us for growth strategy, branding, and paid media support. Email: hello@greenleafmarketing.com",
  "url": "https://www.yellowpages.com/austin-tx/mip/green-leaf-marketing-12345678",
  "email": "hello@greenleafmarketing.com"
}
```

| Field | Label | Format | Description |
|---|---|---|---|
| `keyword` | Keyword | Text | The keyword that produced the result. |
| `title` | Title | Text | The business title or listing name. |
| `description` | Description | Text | The visible summary text associated with the result. |
| `url` | Url | Link | The result URL for the Yellow Pages listing. |
| `email` | Email | Text | The email address extracted from publicly available sources. |

### 💻 How to Use Yellow Pages Email Scraper — Step-by-Step

1. **Open the Actor** — Find **Yellow Pages Email Scraper** in the Apify Store and open the actor page.
2. **Enter Keywords** — Add the business roles, niches, or terms you want to target.
3. **Set Location** *(optional)* — Limit results to a city, region, or broader area if needed.
4. **Add Email Domains** *(optional)* — Include the domains you want the actor to focus on, such as common public inbox domains.
5. **Set Max Emails** — Choose how many emails you want to collect in one run.
6. **Run the Actor** — Start the run and monitor progress in the logs.
7. **Export Results** — Download the dataset when the run finishes and use it for outreach or analysis.

No coding required. Your yellow pages scraping tool is ready in minutes. ⚡

### 💡 Best Use Cases for Yellow Pages Email Scraper

- 🎯 **B2B Lead Generation** — Build targeted lists for outreach using a yellow pages business directory scraper.
- 📣 **Email Marketing** — Find new business contacts for newsletters and campaigns.
- 🤝 **Sales Prospecting** — Discover local businesses and collect contact details for follow-up.
- 🔬 **Market Research** — Map businesses by keyword and location for market analysis.
- 📊 **CRM Enrichment** — Add publicly available contact data to existing lead records.

### Disclaimer

This actor only accesses publicly available data on Yellow Pages. It does not access private profiles, password-protected pages, or restricted content. Users are responsible for complying with applicable laws, including privacy and anti-spam rules, as well as the website’s terms of service. This tool is intended for legitimate use cases such as research, lead generation, and marketing. For data-removal requests, contact 📧 <codebeatapi@gmail.com>.

### 🆘 Support & Feedback

Have a question or found an issue with the **Yellow Pages Email Scraper**? We’re here to help.

- 🐞 **Bug Reports:** Share the issue with our team for investigation.
- ✨ **Custom Solutions & Feature Requests:** Reach out if you need tailored functionality or workflow support.
- 📧 **Email:** <codebeatapi@gmail.com>

Your feedback helps improve this yellow pages lead generation tool.

### Country & Time Targeting

Both filters are applied to the Google query itself, so they shape which pages
the dork is answered from rather than filtering after the fact.

**Target Country** - runs the search as if from that country (`gl`). Turn on
**Strict country filter** to additionally restrict results to pages Google
attributes to it (`cr=countryXX`); that is much tighter and returns noticeably
fewer results. Leave the country on *Global (no country filter)* for worldwide
results.

**Result Language** - restricts results to a single language (`hl` + `lr`).

**Time Range** - limits results to a publication window: past hour, 24 hours,
week, month, year, or an explicit *Custom range* using **Custom range: from** /
**to** in `YYYY-MM-DD` form. A page Google indexed last week is far more likely
to carry a live mailbox than one it last saw five years ago.

Selecting *Custom range* without either date falls back to no time filter rather
than searching all of time by accident.

# Actor input Schema

## `scrapeMode` (type: `string`):

Find New Emails (default) searches Airbnb by keyword. Clean My List skips searching entirely and instead runs the emails you paste into Email List (below) through the same deliverability checks.

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

A list of keywords or queries to search for.

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

Location to filter search results.

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

List of custom email domains

## `emailList` (type: `array`):

Paste the emails you want checked for deliverability. Only used when Scrape Mode is set to "Clean My List".

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

## `verificationMode` (type: `string`):

Quick Check (default) validates syntax and MX records only - fast, no added latency. Deep Check additionally flags disposable-domain addresses and checks each domain against a public spam blocklist (Spamhaus DBL). Off skips validation entirely.

## `minQualityScore` (type: `number`):

Drop any contact whose quality score (0.0-1.0) falls below this. Leave at 0 for no filter.

## `excludeCatchAll` (type: `boolean`):

Drop contacts on domains confirmed to accept mail for any address (only applies when that signal is available).

## `requireMxValid` (type: `boolean`):

Drop any contact whose domain has no valid mail server (MX record).

## `targetCountry` (type: `string`):

Ask Google to answer as if searching from this country. Leave on "Global (no country filter)" for worldwide results.

## `strictCountry` (type: `boolean`):

Restrict results to pages Google attributes to the target country (cr=countryXX), instead of only preferring them. Much tighter targeting, noticeably fewer results.

## `searchLanguage` (type: `string`):

Restrict results to one language. Leave on "Any language" for no filter.

## `timeRange` (type: `string`):

Only return pages Google indexed within this window. Recent pages are more likely to hold a mailbox that still works.

## `customDateFrom` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## `customDateTo` (type: `string`):

Only used when Time Range is "Custom range". Format: YYYY-MM-DD.

## Actor input object example

```json
{
  "scrapeMode": "Find New Emails",
  "keywords": [
    "manager",
    "founder"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "emailList": [],
  "maxEmails": 20,
  "verificationMode": "Quick Check",
  "minQualityScore": 0,
  "excludeCatchAll": false,
  "requireMxValid": false,
  "targetCountry": "Global (no country filter)",
  "strictCountry": false,
  "searchLanguage": "",
  "timeRange": "Any time",
  "customDateFrom": "",
  "customDateTo": ""
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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": [
        "manager",
        "founder"
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com"
    ],
    "emailList": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("code-beat/yellow-pages-email-scraper-ultra-fast-and-precise").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": [
        "manager",
        "founder",
    ],
    "location": "",
    "customDomains": [
        "@gmail.com",
        "@yahoo.com",
    ],
    "emailList": [],
}

# Run the Actor and wait for it to finish
run = client.actor("code-beat/yellow-pages-email-scraper-ultra-fast-and-precise").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": [
    "manager",
    "founder"
  ],
  "location": "",
  "customDomains": [
    "@gmail.com",
    "@yahoo.com"
  ],
  "emailList": []
}' |
apify call code-beat/yellow-pages-email-scraper-ultra-fast-and-precise --silent --output-dataset

```

## MCP server setup

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

```

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/slrc90Hixdv2peJn7/builds/wIOLd3go7uW7Z05L3/openapi.json