Yellow Pages US Scraper — Business Leads (Phone, Address, Website)

Scrape US business listings from yellowpages.com at scale. Search by keyword + city, or paste search / category / business-profile URLs, and get clean, structured leads: business name, phone, full address, website, categories, star rating, review count, and years in business — plus optional best-effort detail enrichment (email, hours, description).

Built for sales teams, lead-gen agencies, market researchers, and AI agents (MCP-ready). Firefox-rendered with residential proxies to reliably clear yellowpages.com's Cloudflare protection.

What you get

Field	Example	Notes
name	Ritz Plumbing Heating, Air & Electrical	Business name
phone	(323) 452-4915	Primary phone
street	1355 S La Brea Ave	Organic listings (ads omit street)
city / state / zip	Los Angeles / CA / 90019	Parsed address parts
fullAddress	1355 S La Brea Ave, Los Angeles, CA 90019	Single-line address
website	http://ritzplumbing.com	When listed
categories	["Plumbers","Heating Contractors"]	All listed categories
primaryCategory	Plumbers	First category
rating	4.5	Star rating (when present)
reviewCount	120	Number of reviews
yearsInBusiness	95	Years in business
snippet	Family-owned since 1929…	Listing blurb
sponsored	false	true = paid/ad placement
profileUrl	https://www.yellowpages.com/.../mip/...	Yellow Pages profile
email / hours / description	best-effort	Only when enrichDetails is on
scrapedAt	2026-06-21T16:00:00.000Z	ISO 8601 timestamp

When to use

• Build B2B lead lists by industry + city (plumbers in Los Angeles, dentists in Chicago…).
• Enrich a CRM with phone, address, and website for local businesses.
• Power an AI agent that needs structured local-business data — single keyword + location in, JSON out.

Not for: yellowpages.com reviews-only export, or non-US Yellow Pages directories.

Input

Field	Type	Description
searchTerms	string	Business type or name, e.g. plumber, coffee shop.
location	string	City+state or ZIP, e.g. Los Angeles, CA or 90210. Blank = nationwide.
startUrls	string[]	Optional. yellowpages.com /search, category, or /mip/ business URLs.
maxResults	integer	Max businesses to return (default 100).
maxPagesPerSearch	integer	Search pages to paginate (~30/page, default 5).
enrichDetails	boolean	Visit each profile for email/hours/description (slower; default false).
proxyConfiguration	object	Residential proxy required (default Apify RESIDENTIAL, US).

Example

{
  "searchTerms": "plumber",
  "location": "Los Angeles, CA",
  "maxResults": 100,
  "maxPagesPerSearch": 5
}

$apify call khadinakbar/yellow-pages-us-scraper --input='{"searchTerms":"dentist","location":"Chicago, IL","maxResults":50}'

Pricing — Pay Per Event

Event	Price
Actor start	$0.005 (per run, per GB)
Business scraped	$0.005 / result

A 100-business run costs about $0.50 plus the start fee. Pay-per-usage (compute + proxy) is also available — pick whichever billing fits your job at run time.

Reliability

• Firefox-rendered pages clear yellowpages.com's Cloudflare challenge.
• Residential proxy is required (datacenter IPs are firewall-blocked by Yellow Pages). The actor defaults to Apify Residential (US) and includes a secondary residential provider fallback for resilience.
• Honest results: if every attempt is blocked, the run fails clearly instead of silently returning an empty dataset. Bad input (no search terms / invalid URLs) ends gracefully with a clear status message rather than a hard error.
• Heavy page assets (images, fonts, media) are skipped to keep proxy bandwidth and cost low.

MCP / AI agents

Available as apify--yellow-pages-us-scraper via the Apify MCP server. Narrow input (keyword + location), flat structured output, and a clear per-result price make it a clean tool call for Claude, GPT, and other agents.

Notes & limitations

• email, hours, and description come only from detail pages (enrichDetails: true) and are best-effort — yellowpages.com detail pages are more heavily protected, so coverage is partial.
• Sponsored/ad listings (sponsored: true) include name, phone, categories, and years, but usually no street address.
• yellowpages.com covers US businesses only.

Legal

This actor collects only publicly available business information from yellowpages.com. Use it in compliance with yellowpages.com's Terms of Service and all applicable laws (including data-protection regulations). You are responsible for how you use the scraped data. This tool is provided for legitimate business research and lead generation.