# Yellow Pages Email Scraper (`solid-scraper/yellow-pages-email-scraper`) Actor 🟑 Yellow Pages Email Scraper extracts verified business emails by category, location, and keywordsβ€”fast and accurate. πŸš€ Perfect for lead generation, sales, and marketing teams seeking targeted outreach at scale. βœ… - **URL**: https://apify.com/solid-scraper/yellow-pages-email-scraper.md - **Developed by:** [SolidScraper](https://apify.com/solid-scraper) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 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/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 ### Yellow Pages Email Scraper πŸ“¬ **Yellow Pages Email Scraper** is an Actor designed to scrape emails from Yellow Pages profiles using your chosen keywords and filters. If you’re looking for a **yellow pages email scraper**, this tool helps you turn directory listings into actionable leads by extracting contact emails that are publicly available. Whether you’re a marketer, sales lead, recruiter, or data analyst, you can use this **yellow pages lead scraper** workflow to enrich outreach lists with **yellow pages scraper email** resultsβ€”at scale, without manually copy-pasting contacts one by one. --- ### Why choose Yellow Pages Email Scraper? | Feature | Benefit | | --- | --- | | βœ… **Keyword-driven email discovery** | Finds emails from Yellow Pages bios and posts related to your keywords | | βœ… **Custom email-domain targeting** | Lets you focus on specific domains (for example, collecting only @gmail.com) | | βœ… **Two scraping engines** | Switch between **cost-effective** and **legacy** for different performance/reliability needs | | βœ… **Retry + resilience logic** | Includes retries and fallbacks for resilience during large runs | | βœ… **Structured JSON dataset output** | Produces consistent records with fields like `keyword`, `title`, `url`, and `email` | | βœ… **Built-in proxy support** | Supports proxy configuration so your runs can stay stable on bigger batches | --- ### Key features - πŸ”Ž **Directory-focused email extraction**: Extracts emails from Yellow Pages bios and posts tied to your search keywords - 🎯 **Custom domain filters**: Use `customDomains` to target only the email addresses that match your preferred domains - 🧠 **Smart targeting with keyword lists**: Feed multiple `keywords` to build broader **yellow pages business leads** coverage - πŸ›‘οΈ **Engine flexibility**: Choose `engine` as `legacy` or `cost-effective` depending on your needs - πŸ”„ **Resilient collection for large searches**: Includes stopping conditions and resilience behavior when results slow down - πŸ’Ύ **Immediate dataset saving**: Each discovered email record is pushed as output data during the run - πŸ€– **Automation-friendly output**: Produces clean JSON rows that you can export to CSV/JSON for downstream use --- ### Input Provide input via an `input.json` file. Example structure: ```json { "keywords": ["founder", "marketing"], "location": "United States", "platform": "Yellow Pages", "customDomains": ["@gmail.com"], "maxEmails": 20, "engine": "legacy", "proxyConfiguration": { "useApifyProxy": true } } ```` #### Input Fields | Field | Required | Description | | --- | --- | --- | | `keywords` | βœ… | A list of keywords to search for. The scraper uses these to find Yellow Pages profiles where emails appear in bios and posts related to your terms. | | `location` | ❌ | Location to filter search results. Leave it blank for broader coverage. | | `platform` | ❌ | Select platform. This actor supports `Yellow Pages`. | | `customDomains` | ❌ | List of custom email domains to keep (example: `@gmail.com`). This helps you build a more targeted **yellowpages contact email finder** list. | | `maxEmails` | ❌ | Maximum number of emails to collect. The scraper stops once this limit is reached. Higher limits may take longer but provide more potential results. | | `engine` | ❌ | Choose scraping engine. Options are `cost-effective` (Cost Effective (New)) and `legacy` (Legacy). | | `proxyConfiguration` | ❌ | Proxy settings for this Actor. Use this if you want more control over network routing for your **bulk email extraction software** workflow. | *** ### Output The actor saves discovered records in JSON rows (via `Actor.push_data`). Example output row: ```json { "network": "Yellow Pages.com", "keyword": "marketing", "title": "No title", "description": "No data", "url": "No URL", "email": "example@gmail.com", "proxyGroups": [] } ``` #### Output Fields | Field | Type | Description | | --- | --- | --- | | `network` | string | Source network name for the record (set to `Yellow Pages.com`). | | `keyword` | string | The keyword that led to this email being found. | | `title` | string | Title text from the matched directory result (may be `No title`). | | `description` | string | Description text extracted from the result (may be `No data`). | | `url` | string | URL associated with the matched result (may be `No URL`). | | `email` | string | The extracted email address that matches your `customDomains` filters. | | `proxyGroups` | array | Proxy groups provided/used for the run (value comes from the actor input during proxy setup). | > Note: The dataset rows are only pushed when an email is extracted and hasn’t been seen before in the same run (deduplicated via a `seen_emails` set). *** ### How to use Yellow Pages Email Scraper (via Apify Console) 1. **Open Apify Console**\ Log in at [console.apify.com](https://console.apify.com) and navigate to the **Actors** tab. 2. **Find the actor**\ Search for **Yellow Pages Email Scraper** and open its actor page. 3. **Go to INPUT**\ Use the input form (or upload an `input.json`) and set at least `keywords` (required). 4. **Add targeting**\ Set `customDomains` (for example, `@gmail.com`) to run a more precise **scrape yellow pages emails** workflow. 5. **Choose the engine**\ Pick `engine` as `legacy` or `cost-effective` based on your needs for reliability vs cost/performance. 6. **Configure proxies (optional)**\ If you have network requirements, fill in `proxyConfiguration` to enable reliable bulk scraping runs for **directory listing email scraper** use cases. 7. **Set the limit**\ Adjust `maxEmails` to control how many email addresses you want to collect before the actor stops. 8. **Run and monitor output**\ Start the run and watch logs for progress. When it finishes, open the **OUTPUT** dataset and export results (JSON/CSV). No coding required β€” get targeted Yellow Pages email leads in minutes with this **yellow pages to email list** workflow. *** ### Advanced features & SEO optimization - πŸš€ **Engine selection for different needs**: Choose between `legacy` and `cost-effective` to match your priorities for speed and resilience while scraping **yellow pages scraper email** data - 🎯 **Domain-first targeting**: Use `customDomains` to focus on specific inbox providers and build cleaner **local business email scraper** outputs - 🧾 **Consistent structured rows**: Each record is pushed with the same field set (`keyword`, `title`, `description`, `url`, `email`, etc.) so it’s easy to analyze - πŸ’Ύ **Progress tracking for long runs**: The actor persists progress during execution, supporting smoother continuation on larger jobs - 🧰 **Built for automation**: Ideal when you want a **B2B lead email scraper** feeding into CRM enrichment or outreach list-building pipelines *** ### Best use cases - πŸ“ˆ **Sales teams building outbound lists**: Quickly assemble **yellow pages business leads** with emails filtered to your preferred domains - 🧠 **Market researchers analyzing contact presence**: Measure how often businesses include reachable emails across directory categories using your keyword sets - βœ‰οΈ **Email marketing ops**: Generate a directory-based email seed list using `customDomains` for cleaner deliverability testing - 🏒 **Local lead gen for agencies**: Extract targeted contacts as part of a **business directory email scraper** workflow for specific regions via `location` - 🧾 **Data analysts enriching datasets**: Join directory results with your existing company tables using consistent `keyword`, `url`, and `email` fields - πŸ”§ **Developer pipelines for contact enrichment**: Automate **website email extractor for directories** style tasks with repeatable structured output - 🀝 **Recruiters sourcing organizations**: Build a **yellow pages lead scraper** dataset to help contact the right departments faster *** ### Technical specifications - **Supported Input Formats** - βœ… JSON input with these fields: `keywords` (required), plus optional `location`, `platform`, `customDomains`, `maxEmails`, `engine`, and `proxyConfiguration` - **Proxy Support** - βœ… Yes, via `proxyConfiguration` - βœ… Engine option supports different proxy approaches (configured by `engine`) - **Retry Mechanism** - βœ… Includes retry and fallback behavior when results are missing or requests fail during scraping - **Dataset Structure** - βœ… JSON dataset rows pushed per discovered email - βœ… Includes: `network`, `keyword`, `title`, `description`, `url`, `email`, `proxyGroups` - **Rate Limits & Performance** - βœ… Supports large scraping jobs, but **large searches or high email limits may take longer** - βœ… You can increase runtime using Run Options timeouts (the actor notes a default timeout of **3600 s / 1 hr**) - **Limitations** - ❌ Only emails found in publicly available Yellow Pages profile bios/posts are extracted - ❌ Setting a higher `maxEmails` increases potential coverage but does not guarantee reaching the exact limit *** ### FAQ #### Does Yellow Pages Email Scraper work without writing code? βœ… Yes. You can run **Yellow Pages Email Scraper** directly from Apify Console by providing the required `keywords` and optional filters like `customDomains` and `location`. #### What does the actor actually extract? βœ… It extracts email addresses that appear on Yellow Pages profiles, specifically from bios and posts related to your keywords, and outputs them as structured JSON rows. #### How do I target specific email providers (like Gmail only)? You can set `customDomains` to filter emails by domain (for example, using `@gmail.com`). This is a common way to improve targeting for **yellowpages contact email finder** and **directory listing email scraper** workflows. #### What happens if I set `maxEmails` to a very high number? The actor will stop once it reaches the collected limit, but it may take longer to collect more emails. The actor also notes that higher limits don’t guarantee the exact number will be reached. #### How do I improve results if I’m getting low email counts? If results seem low, re-run with broader keywords and more related terms, and/or add more domains to `customDomains` so the **yellow pages scraper email** extraction has more matching opportunities. #### Can I configure proxies for large bulk runs? Yes. Use `proxyConfiguration` and choose an `engine` (`legacy` or `cost-effective`) to support stable bulk scraping for **bulk email extraction software** use cases. #### Is this tool suitable for building a β€œYellow Pages to email list” for outreach? It can be, as long as you use the output responsibly. The actor collects only emails from publicly available sources. Always ensure your outreach practices comply with applicable laws and platform rules. *** ### Support & feature requests Have questions about **Yellow Pages Email Scraper** or want to suggest improvements for scraping yellow pages emails at scale? We’d love to hear from you. - πŸ’‘ **Feature Requests**: Examples include adding more export conveniences (CSV-focused output), improving keyword targeting options, or supporting additional email-domain filtering behaviors - πŸ“§ **Contact**: Reach us at Your feedback helps shape future iterations of this **yellow pages email scraper**. *** *If you’re after the most comprehensive, SEO-optimized **Yellow Pages Email Scraper** experience, run your first keyword batch today and scale into clean, domain-targeted email leads.* ### Disclaimer **This actor accesses publicly accessible sources only.** It does not access private profiles, authenticated data, or password-protected pages. It is your responsibility to comply with applicable laws (including GDPR/CCPA where relevant), spam regulations, and any platform terms of service. For data-removal requests, contact . Please use this tool responsibly, ethically, and for legitimate purposes only. # 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": "Yellow Pages", "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 '' with your token const client = new ApifyClient({ 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("solid-scraper/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 '' with your token. client = ApifyClient("") # 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("solid-scraper/yellow-pages-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 solid-scraper/yellow-pages-email-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=solid-scraper/yellow-pages-email-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Yellow Pages Email Scraper", "description": "🟑 Yellow Pages Email Scraper extracts verified business emails by category, location, and keywordsβ€”fast and accurate. πŸš€ Perfect for lead generation, sales, and marketing teams seeking targeted outreach at scale. βœ…", "version": "0.0", "x-build-id": "IKTYaJRFOGDwXWdjf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solid-scraper~yellow-pages-email-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solid-scraper-yellow-pages-email-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/solid-scraper~yellow-pages-email-scraper/runs": { "post": { "operationId": "runs-sync-solid-scraper-yellow-pages-email-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/solid-scraper~yellow-pages-email-scraper/run-sync": { "post": { "operationId": "run-sync-solid-scraper-yellow-pages-email-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": "A list of keywords to search for.", "default": [ "founder", "marketing" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Location to filter search results.", "default": "" }, "platform": { "title": "Platform", "enum": [ "Yellow Pages" ], "type": "string", "description": "Select platform.", "default": "Yellow Pages" }, "customDomains": { "title": "Custom Email Domains", "type": "array", "description": "List of custom email domains", "default": [ "@gmail.com" ], "items": { "type": "string" } }, "maxEmails": { "title": "Max Emails", "minimum": 1, "maximum": 10000, "type": "integer", "description": "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.", "default": 20 }, "engine": { "title": "Engine", "enum": [ "cost-effective", "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": "Configure proxies for this Actor." } } }, "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 } } } } } } } } } } ```