Yellow Pages Scraper

Scrape business listings from Yellow Pages (yellowpages.com). Extract comprehensive business data including phone numbers, addresses, websites, hours, reviews, and more for any category and location in the US.

Features

• Category Search: Search by any business category (plumber, restaurant, dentist, etc.)
• Location Targeting: Search by city/state or ZIP code
• Comprehensive Data: Phone, address, website, hours, rating, reviews
• Smart Filtering: Filter by rating, website presence, phone availability
• Review Extraction: Optionally scrape review snippets
• Export Ready: Clean data ready for CRM import or outreach

Use Cases

• Lead Generation: Build prospect lists for sales outreach
• Market Research: Analyze competitor presence in specific areas
• Local SEO: Find businesses for citation building or backlink opportunities
• Directory Building: Populate local business directories
• Competitive Analysis: Map out business landscape in target markets
• Data Enrichment: Enhance existing business databases with YP data

Input Parameters

Parameter	Type	Description
searchQuery	string	Business category or keyword (e.g., "plumber")
location	string	City/state or ZIP code (e.g., "Miami, FL")
maxResults	number	Maximum businesses to scrape (default: 100)
includeReviews	boolean	Extract review snippets (default: false)
includeHours	boolean	Extract business hours (default: true)
includeCategories	boolean	Extract all categories (default: true)
minRating	number	Minimum rating filter 0-5 (default: 0)
hasWebsite	boolean	Only businesses with websites (default: false)
hasPhone	boolean	Only businesses with phone (default: false)
proxyConfiguration	object	Proxy settings
demoMode	boolean	Return sample data for testing

Output

Each business listing includes:

{
  "name": "ABC Plumbing Services",
  "phone": "(305) 555-1234",
  "address": "123 Main Street",
  "city": "Miami",
  "state": "FL",
  "zipCode": "33101",
  "fullAddress": "123 Main Street, Miami, FL 33101",
  "website": "https://abcplumbing.com",
  "yellowPagesUrl": "https://www.yellowpages.com/miami-fl/mip/abc-plumbing-123456",
  "rating": 4.5,
  "reviewCount": 47,
  "categories": ["Plumbers", "Water Heater Repair", "Drain Cleaning"],
  "hours": {
    "Monday": "8:00 AM - 6:00 PM",
    "Tuesday": "8:00 AM - 6:00 PM",
    "Wednesday": "8:00 AM - 6:00 PM",
    "Thursday": "8:00 AM - 6:00 PM",
    "Friday": "8:00 AM - 6:00 PM",
    "Saturday": "9:00 AM - 2:00 PM",
    "Sunday": "Closed"
  },
  "yearsInBusiness": 15,
  "accredited": true,
  "reviews": [
    {
      "author": "John D.",
      "rating": 5,
      "text": "Excellent service! They fixed my leak same day.",
      "date": "2024-01-15"
    }
  ],
  "scrapedAt": "2024-12-21T10:30:00.000Z"
}

Example Usage

Basic Category Search

{
  "searchQuery": "plumber",
  "location": "Miami, FL",
  "maxResults": 50
}

Filtered Search with Reviews

{
  "searchQuery": "restaurant",
  "location": "New York, NY",
  "maxResults": 100,
  "minRating": 4,
  "hasWebsite": true,
  "includeReviews": true
}

Lead Generation for Outreach

{
  "searchQuery": "hvac contractor",
  "location": "Los Angeles, CA",
  "maxResults": 200,
  "hasWebsite": true,
  "hasPhone": true,
  "minRating": 3.5
}

Pricing

This actor uses pay-per-event pricing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
listing_scraped	Per business scraped	$0.005
review_scraped	Per review extracted	$0.002

Example costs:

• 100 businesses with 3 reviews each: $0.10 + (100 × $0.005) + (300 × $0.002) = $1.20
• 200 businesses, no reviews: $0.10 + (200 × $0.005) = $1.10

Data Quality

• Phone numbers are validated and formatted
• Addresses are parsed into components
• Duplicate businesses are automatically filtered
• Rating and review counts are normalized

Rate Limiting

The scraper includes intelligent rate limiting to respect Yellow Pages:

• Automatic delays between requests
• Proxy rotation for reliability
• Retry logic for failed requests

Limitations

• US businesses only (yellowpages.com)
• Maximum 1000 results per run
• Some businesses may have incomplete data
• Review extraction increases run time

Integration

Export data directly to:

• Google Sheets
• CSV/Excel
• CRM systems (via webhook)
• Databases (via API)

Support

For issues or feature requests, contact support.

---

Keywords

yellow pages scraper, business directory scraper, local business data, yellow pages api, business listings