YellowPages USA Lead Generator

YellowPages USA Lead Generator

Scrape business listings from YellowPages.com, the largest US business directory with 3,000+ categories across every city in the United States. Extract names, phone numbers, emails, addresses, ratings, reviews, hours, categories, and websites. Listing and detail modes with Pay-per-event pricing.

Build targeted lead lists from YellowPages — search any industry and US city, extract business contacts with emails, phone numbers, ratings, and hours at scale.

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

parsebird/yellowpages-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/yellowpages-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: searchQuery (string, e.g. "plumbers", "restaurants"), location (string, e.g. "Los Angeles, CA", "New York, NY", "90210"), category (string, optional — "attorneys"/"plumbers"/"dentists"/"restaurants"/etc.), maxPages (integer, default 5), maxResults (integer, default 100), includeDetails (boolean, default false — enables email, hours, description extraction). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~yellowpages-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations

What does YellowPages USA Lead Generator do?

This Actor scrapes yellowpages.com using Playwright with residential US proxies to bypass Cloudflare protection. It supports two modes:

Listing mode (default, fast):

Field	Example
Business name	Joe's Plumbing LLC
Phone	(512) 555-0142
Address	1234 Main St, Austin, TX 78701
City / State / ZIP	Austin / TX / 78701
Rating	4.5
Review count	47
Detail URL	https://www.yellowpages.com/austin-tx/mip/...

Detail mode (adds per business):

Field	Example
Email	joe@joesplumbing.com
Image	https://i3.ypcdn.com/blob/...
Hours	{"Mon - Sun": "12:00 am - 11:59 pm"}
Description	Full business description text
Categories	["Plumbers", "Water Heaters"]
Website	https://joesplumbing.com
Years in business	12
Amenities	["Licensed", "Insured", "Free Estimates"]
Payment methods	["Visa", "Mastercard", "Cash"]
Neighborhoods	["Downtown", "East Side"]
Accreditations	["BBB Accredited"]
Social links	{"facebook": "...", "instagram": "..."}

Why scrape YellowPages?

• Lead generation — Build targeted prospect lists of plumbers, dentists, lawyers, or any industry in any US city with direct emails and phone numbers
• Sales prospecting — Get verified business contacts for cold outreach, SDR campaigns, and appointment setting
• Market research — Analyze business density, ratings, and competition across categories and cities
• Competitive intelligence — Find all competitors in a specific category and location, compare ratings and review counts
• Data enrichment — Supplement your CRM with business details, emails, websites, hours, and categories
• Insurance & finance — Find businesses by industry and location for quoting, underwriting, and financial services
• Directory building — Feed business data into your own marketplace, aggregation platform, or local directory

How to use

1. Go to the YellowPages USA Lead Generator page on Apify Store
2. Click Try for free
3. Configure your input:
   • Search Query — e.g. plumbers, Italian restaurants, dentists
   • Location — e.g. Los Angeles, CA, New York, NY, 90210
   • Category — Optional: select a pre-defined category for more reliable results
   • Include Details — Enable to extract emails, hours, and full business descriptions
4. Click Start and wait for the run to finish
5. Download your data in JSON, CSV, Excel, or connect via API

Tip: Use Category mode when you know the exact YellowPages category (e.g. "attorneys", "plumbers"). Use Search Query mode for free-text searches (e.g. "emergency plumber near me").

Input parameters

Parameter	Type	Default	Description
searchQuery	string	"restaurants"	Business type, name, or keyword. Leave empty if using Category.
location	string	"Los Angeles, CA"	City and state (e.g. New York, NY) or ZIP code (e.g. 90210). Required.
category	string	""	Pre-defined YellowPages category slug (e.g. attorneys, plumbers). Overrides Search Query when set.
maxPages	integer	5	Max listing pages (30 businesses per page)
maxResults	integer	100	Max businesses to return
includeDetails	boolean	false	Fetch detail pages for email, hours, description, amenities, and more

Output data

Listing mode example:

{
    "businessName": "Joe's Plumbing LLC",
    "phone": "(512) 555-0142",
    "address": "1234 Main St, Austin, TX 78701",
    "streetAddress": "1234 Main St",
    "city": "Austin",
    "state": "TX",
    "zip": "78701",
    "rating": 4.5,
    "reviewCount": 47,
    "detailUrl": "https://www.yellowpages.com/austin-tx/mip/joes-plumbing-12345678",
    "rank": 1,
    "scrapedAt": "2026-03-28T12:00:00.000Z"
}

Detail mode adds:

{
    "email": "joe@joesplumbing.com",
    "imageUrl": "https://i3.ypcdn.com/blob/...",
    "hours": {
        "Mon - Fri": "8:00 am - 5:00 pm",
        "Sat": "9:00 am - 2:00 pm"
    },
    "description": "Joe's Plumbing LLC has been serving Austin and surrounding areas for over 12 years. We specialize in residential and commercial plumbing...",
    "categories": ["Plumbers", "Water Heaters"],
    "website": "https://joesplumbing.com",
    "yearsInBusiness": 12,
    "amenities": ["Licensed", "Insured", "Free Estimates", "24/7 Emergency Service"],
    "paymentMethods": ["Visa", "Mastercard", "American Express", "Cash", "Check"],
    "neighborhoods": ["Downtown", "East Side", "South Austin"],
    "accreditations": ["BBB Accredited"],
    "socialLinks": {
        "facebook": "https://facebook.com/joesplumbing",
        "instagram": "https://instagram.com/joesplumbing"
    }
}

Use with the Apify API

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("parsebird/yellowpages-scraper").call(run_input={
    "searchQuery": "plumbers",
    "location": "Austin, TX",
    "maxResults": 50,
    "includeDetails": True,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['businessName']} - {item.get('phone', 'N/A')} - {item.get('email', 'N/A')}")

Pricing

This Actor uses Pay-per-event pricing:

Event	Cost	Rate
yp-business-listing	$0.006	$6 per 1,000 businesses
yp-business-detail	$0.021	$21 per 1,000 businesses

Listing mode charges only yp-business-listing per business found. Detail mode charges only yp-business-detail per business enriched (no double-charging).

Cost examples (listing mode):

• 30 businesses (1 page): $0.18
• 100 businesses: $0.60
• 1,000 businesses: $6.00

Cost examples (detail mode):

• 30 businesses (1 page): $0.63
• 100 businesses: $2.10
• 1,000 businesses: $21.00

You only pay for the businesses actually returned.

Tips and best practices

• Start small — Set maxResults to 5-10 with includeDetails enabled to preview the data before running a full scrape
• Use Category mode for precision — Select a pre-defined category (e.g. "attorneys") for more reliable results than free-text search
• Include state abbreviation — Use Los Angeles, CA instead of just Los Angeles for accurate location matching
• Listing mode for lead lists — Listing mode includes name, address, phone, and rating — enough for quick lead generation
• Detail mode for enrichment — Enable detail mode when you need emails, business hours, payment methods, categories, websites, and full descriptions
• Scheduling — Set up weekly runs to track new businesses or changes in ratings and review counts
• Combine queries — Run multiple scrapes with different search terms or categories to build comprehensive databases

Integrations

Connect this Actor to your workflow:

• Google Sheets — Export results directly
• Webhooks — Trigger actions when new data arrives
• API — Access data programmatically via the Apify API
• Zapier / Make — Automate downstream workflows
• Slack — Get notified when new high-rated businesses appear

Limitations

• Currently supports US Yellow Pages (yellowpages.com) only
• YellowPages is behind Cloudflare protection, requiring residential US proxies (built-in on Apify platform). Local testing requires a US-based internet connection or proxies.
• Email extraction requires visiting individual business detail pages, which is slower but returns more contact data — typically 15-25% of listings have emails
• Yellow Pages shows a maximum of 30 results per page and roughly 3,000 results per search query
• Some businesses may not have websites, emails, ratings, or hours listed depending on their profile completeness
• Detail pages are fetched with small delays to avoid rate limiting