Yellow Pages Scraper

Extract rich business directory listings, contact details, opening hours, and ratings from YellowPages.com using stealthy browser automation powered by Playwright and Camoufox.

---

🌟 What does Yellow Pages Scraper do?

The Yellow Pages Scraper enables you to automatically collect public business listings and contact information from YellowPages.com. Whether you enter a custom search term and location or provide specific search URLs, this Actor extracts detailed business data and delivers it in clean, structured formats like JSON, CSV, Excel, or HTML.

Key Features

• 🛡️ Anti-Bot Evasion: Built with Camoufox (anti-fingerprinting Firefox engine) and Playwright to bypass detection without sophisticated proxy setups.
• 📍 Targeted Scraping: Search by keyword and location (e.g., "Car Wash in Kansas City, MO") or feed custom start URLs directly.
• 📞 Complete Business Profiles: Collects business names, phone numbers, full addresses (street, city, state, zip), review scores, opening hours, categories, and direct website links.
• ⚡ High Scalability & Resiliency: Built on the official Apify Crawlee SDK, offering automatic retry logic and configurable timeouts.

---

💡 Why scrape Yellow Pages?

Yellow Pages is one of the largest online B2B and local business directories in North America. Scraping Yellow Pages provides valuable data for:

• B2B Lead Generation: Build targeted outreach lists of local businesses complete with telephone numbers, addresses, and official websites.
• Competitor & Market Analysis: Map local business density, identify market gaps, and benchmark competitor ratings.
• Local SEO & Citation Audits: Verify NAP (Name, Address, Phone number) consistency across business directories.
• Data Enrichment: Enrich existing CRM records with verified phone numbers and business categories.

---

⚙️ Input Parameters

You can configure the Actor via JSON input in the Apify Console.

Field	Type	Description	Default / Example
start_urls	array	List of YellowPages search or listing URLs to crawl.	[{"url": "https://www.yellowpages.com/search?search_terms=car+wash&geo_location_terms=Kansas+City%2C+MO"}]

Example input.json

{
  "start_urls": [
    {
      "url": "[https://www.yellowpages.com/search?search_terms=car+wash&geo_location_terms=Kansas+City%2C+MO](https://www.yellowpages.com/search?search_terms=car+wash&geo_location_terms=Kansas+City%2C+MO)"
    },
    {
      "url": "[https://www.yellowpages.com/search?search_terms=plumber&geo_location_terms=Chicago%2C+IL](https://www.yellowpages.com/search?search_terms=plumber&geo_location_terms=Chicago%2C+IL)"
    }
  ]
}


## 📊 Output Data Format

The Actor stores scraped business details in the default Apify Dataset. Below is an example of the structured JSON output:

```json
{
  "name": "GO Car Wash",
  "url": "[https://www.yellowpages.com/kansas-city-mo/mip/go-car-wash-574949481](https://www.yellowpages.com/kansas-city-mo/mip/go-car-wash-574949481)",
  "telephone": "(816) 892-4583",
  "streetAddress": "13341 State Line Rd",
  "locality": "Kansas City",
  "region": "MO",
  "postalCode": "64145",
  "country": "US",
  "ratingValue": 4.5,
  "reviewCount": 12,
  "openingHours": [
    "Mo-Sa 07:00-20:00",
    "Su 09:00-18:00"
  ],
  "categories": [
    "Car Wash"
  ],
  "website": "[https://gocarwash.com](https://gocarwash.com)",
  "summary": "Family owned car wash offering soft cloth washes and detailing.",
  "scrapedAt": "2026-07-30T11:08:23Z"
}

---

🚀 How to use Yellow Pages Scraper via API

You can easily run this Actor programmatically using the Apify API or Apify Python SDK.

Python SDK Example

from apify_client import ApifyClient

# Initialize the ApifyClient with your API token
client = ApifyClient("YOUR_APIFY_TOKEN")

# Prepare the Actor input
run_input = {
    "start_urls": [
        {"url": "[https://www.yellowpages.com/search?search_terms=dentist&geo_location_terms=Los+Angeles%2C+CA](https://www.yellowpages.com/search?search_terms=dentist&geo_location_terms=Los+Angeles%2C+CA)"}
    ]
}

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

# Fetch and print results from the dataset
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Business: {item.get('name')} | Phone: {item.get('telephone')}")

---

⚖️ Is scraping Yellow Pages legal?

The Yellow Pages Scraper extracts publicly available business information publicly displayed on YellowPages.com. It does not scrape private user data or access content behind paywalls.

When scraping directories, ensure compliance with local privacy laws (such as GDPR or CCPA) and use the extracted data responsibly for legitimate business operations.

---

❓ FAQ & Troubleshooting

• Does this Actor extract email addresses? YellowPages typically hides email addresses or does not expose them directly on public search cards. If present on the business detail page, the scraper will capture it; otherwise, you can utilize the extracted website URL with an email finder tool.
• Why do I see connection timeout errors? YellowPages occasionally enforces rate limiting on certain IP ranges. If you experience timeouts, consider enabling Apify Residential Proxies in the Actor settings.

undefined