# 🔥Advance US YellowPages Business Scraper (`ramman/yellow-pages-business-scraper`) Actor

🔥This actor scrapes Yellow Pages business directories and extracts verified contact information, ready to use for sales, marketing, or B2B lead generation.

- **URL**: https://apify.com/ramman/yellow-pages-business-scraper.md
- **Developed by:** [ramman](https://apify.com/ramman) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 16 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$150.00 / 1,000 yellow pages business scraper uses

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Yellow Pages Business Scraper - Lead Generation Tool

Transform your lead generation process with this powerful Yellow Pages scraper. Built specifically for Apify, this actor automatically extracts real business contact information from Yellow Pages directories, giving you access to thousands of potential leads in minutes.

### What This Tool Does

This Yellow Pages scraper is your secret weapon for building comprehensive business databases. Instead of manually searching through hundreds of Yellow Pages listings, this tool automatically:

- **Discovers businesses** by searching Yellow Pages with your keywords and location
- **Extracts contact details** including business names, phone numbers, addresses, and websites
- **Handles pagination** automatically, so you get results from multiple pages
- **Delivers clean data** in structured JSON format ready for your CRM or marketing tools

### Why Yellow Pages Scraping?

Yellow Pages remains one of the most comprehensive business directories available. While many businesses have moved online, Yellow Pages still contains:

- **Local business listings** that may not appear in Google searches
- **Verified contact information** including physical addresses and phone numbers
- **Business categories** that help you target specific industries
- **Geographic data** perfect for location-based marketing campaigns

#### Built for Yellow Pages

Unlike generic scrapers, this tool is specifically optimized for Yellow Pages:

- **Custom selectors** that understand Yellow Pages structure
- **Pagination handling** that follows "next page" links automatically
- **URL generation** that creates proper search queries from your keywords
- **Anti-blocking measures** to ensure reliable data collection

### How to Use This Tool

Configure Your Search
Enter your search parameters:

- **Search Keyword**: What type of business you want (e.g., "restaurants", "plumbers", "lawyers")
- **Location**: Where to search (e.g., "New York NY", "Los Angeles CA", "10001")
- **Max Pages**: How many pages to scrape (default: 5, max: 200)
- **Extract Websites**: Whether to get business website URLs (Yes/No)
- **Include Source URL**: Whether to include Yellow Pages links (Yes/No)

### Input Parameters Explained

| Parameter | Description | Required | Default |
|-----------|-------------|----------|---------|
| `searchKeyword` | What type of business you're looking for (e.g., "plumbers", "lawyers", "restaurants") | Yes | "restaurants" |
| `location` | Where to search (city, state, or ZIP code) | Yes | "New York NY" |
| `maxPagesToScrape` | How many pages to process (more pages = more businesses) | No | 5 |
| `extractWebsites` | Whether to extract business website URLs | No | true |
| `includeSourceUrl` | Include original Yellow Pages links in output | No | false |

### What You'll Get

Each business listing includes comprehensive information:

```json
{
  "businessName": "Joe's Pizza & Restaurant",
  "phone": "+1 (555) 123-4567",
  "address": "123 Main Street, New York, NY 10001",
  "website": "https://joespizza.com",
  "scrapedAt": "2024-01-15T10:30:00.000Z"
}
```

### Real-World Use Cases

#### Sales Teams

Build prospect lists by scraping businesses in your target market. Get phone numbers and addresses for cold calling and direct mail campaigns.

#### Marketing Agencies

Create comprehensive business databases for email marketing, social media campaigns, and market research.

#### Business Development

Identify potential partners, competitors, and market opportunities in specific geographic areas.

#### Market Research

Analyze business density, industry distribution, and market saturation in different locations.

### How It Works

The tool works in simple steps:

1. **Search**: Creates Yellow Pages search URLs from your keywords and location
2. **Extract**: Gets business data from each page
3. **Follow**: Automatically finds and follows next page links
4. **Format**: Cleans and formats the information
5. **Deliver**: Saves structured data ready for your use

**Ready to transform your lead generation?** This Yellow Pages scraper gives you access to thousands of business contacts in minutes, not hours. Deploy it today and start building your prospect database!

*Built specifically for Yellow Pages US business directory scraping with lead generation in mind.* 🎯📊

# Actor input Schema

## `searchKeyword` (type: `string`):

What type of business to search for (e.g., restaurants, plumbers, lawyers)

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

City, State or ZIP code to search in (e.g., New York NY, 10001)

## `maxPagesToScrape` (type: `integer`):

Maximum number of Yellow Pages to scrape (more pages = more businesses)

## `extractWebsites` (type: `boolean`):

Try to extract website URLs from business listings

## `includeSourceUrl` (type: `boolean`):

Include the original Yellow Pages URL in the output

## Actor input object example

```json
{
  "searchKeyword": "restaurants",
  "location": "New York NY",
  "maxPagesToScrape": 5,
  "extractWebsites": true,
  "includeSourceUrl": 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("ramman/yellow-pages-business-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("ramman/yellow-pages-business-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 '{}' |
apify call ramman/yellow-pages-business-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ramman/yellow-pages-business-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/OAaKaPWewxMJcoknh/builds/RFr4J0l27y5UeQdA2/openapi.json