Yellow Pages Scraper — US Business Leads

Extract verified US business contact data from YellowPages.com. Phone numbers, emails, addresses, ratings, hours, and 15+ fields. Built for lead generation at any scale — one city or all fifty states.

Handles Cloudflare automatically. No configuration required beyond a search term and location.

What data do you get?

Field	Example	Coverage
name	Clarke Kent Plumbing	100%
phone	(512) 766-0970	100%
streetAddress	1408 W Ben White Blvd	99%
city	Austin	100%
state	TX	100%
postalCode	78704	99%
categories	["Plumbers", "Air Conditioning"]	98%
rating	4.5	85%
reviewCount	127	85%
website	http://www.clarkekentplumbing.com	70%
email	info@business.com	40%*
openingHours	["Mo-Fr 09:00-17:00"]	75%
openStatus	Open Now	80%
priceRange	$$	45%
yearsInBusiness	23	60%
amenities	["Licensed", "Insured"]	50%
paymentMethods	["Visa", "Mastercard"]	35%*
url	https://www.yellowpages.com/...	100%
ypid	543210987	100%
rank	1	100%
searchTerm	plumbers	100%
location	austin-tx	100%

*Fields marked with * require Include Detail Pages to be enabled.

Use cases

• Lead generation — Build targeted prospect lists by category and city. Export to CSV and load directly into your CRM or outreach tool.
• Sales prospecting — Find businesses by type across specific markets, with phone numbers and websites ready for outreach.
• Local market research — Compare business density, ratings, and competition across markets.
• Data enrichment — Append phone, address, hours, and categories to existing business records.
• Agency workflows — Run recurring scrapes across dozens of locations and categories for client deliverables.

Why this scraper?

• Cloudflare bypass that actually works — YellowPages sits behind Cloudflare. Most scrapers fail silently or break after a few pages. This one uses residential IP rotation and automatic retry to handle challenges without manual intervention.
• Schema.org JSON-LD extraction — Data is pulled from structured markup embedded in the page, not brittle CSS selectors. More accurate, more stable across site changes.
• Email extraction — Enable detail page scraping to pull email addresses from individual business profiles. Not available from search results alone.
• Fast and efficient — Compiled Go binary. Typical run: 90 results across 3 pages in under 15 seconds.

How to use

1. Open the actor and click Try for free.
2. Enter search terms (e.g. plumbers, dentists, restaurants).
3. Enter locations in city-state format (e.g. austin-tx, new-york-ny).
4. Set Max Pages to cap results, or leave at 0 for all available pages (~30 per page).
5. Enable Include Detail Pages if you want emails and payment methods.
6. Set proxy to Residential group, US country. Required — non-US IPs are blocked by Cloudflare.
7. Run and download as JSON, CSV, or Excel.

Input example

{
  "searchTerms": ["plumbers", "electricians"],
  "locations": ["austin-tx", "dallas-tx"],
  "maxPages": 3,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Output example

{
  "ypid": "10674347",
  "name": "Clarke Kent Plumbing",
  "url": "https://www.yellowpages.com/austin-tx/mip/clarke-kent-plumbing-10674347",
  "phone": "(512) 766-0970",
  "email": "admin@clarkekentplumbing.com",
  "website": "http://www.clarkekentplumbing.com/",
  "streetAddress": "1408 W Ben White Blvd",
  "city": "Austin",
  "state": "TX",
  "postalCode": "78704",
  "neighborhood": "South Lamar",
  "categories": ["Plumbers", "Air Conditioning Contractors & Systems", "Furnaces-Heating"],
  "rating": 2.87,
  "reviewCount": 15,
  "yearsInBusiness": 23,
  "openStatus": "closed now",
  "openingHours": ["Mo-Fr 09:00-17:00"],
  "paymentMethods": ["check", "amex", "discover", "visa", "cash", "master card"],
  "searchTerm": "plumbers",
  "location": "austin-tx",
  "rank": 2
}

Input parameters

Parameter	Type	Required	Default	Description
searchTerms	string[]	Yes	—	Business categories or keywords
locations	string[]	Yes	—	Cities in city-state format
maxPages	integer	No	0 (all)	Max pages per search. Each page ~30 results.
includeDetails	boolean	No	false	Fetch detail pages for email, payment methods. Doubles request count.
proxyConfiguration	object	No	—	Use Residential group + US country. Required for reliable results.

Pricing

Pay only for what you scrape. No monthly subscription.

Component	Price
Per result	$0.005
Per run (start fee)	$0.10

Example: 1,000 business leads across 10 searches = $6.00 total ($5.00 for results + $1.00 for starts).

Proxy costs (residential US) are billed separately by Apify at standard platform rates.

FAQ

Is it legal to scrape Yellow Pages? YellowPages.com publishes publicly accessible business directory data. Users are responsible for complying with applicable laws and YellowPages.com's terms of service.

Do I need residential proxies? Yes. YellowPages uses Cloudflare which blocks datacenter IPs. Use the Residential proxy group with US country code. Non-US IPs are also blocked.

How many results can I get per search? Up to 30 results per page, up to 100 pages (3,000 results per search term + location). Run multiple terms and locations to scale further.

What if Cloudflare blocks the scraper? The scraper automatically rotates residential IPs and retries up to 5 times. Most challenges resolve in 1–2 attempts. If all retries fail for a search, it logs the error and continues to the next search.

How fast is it? Typically 90–100 results across 3 pages in under 15 seconds.

Integrations

Export results to Google Sheets, Slack, or your CRM using Apify's built-in integrations. Go to Storage > Dataset > Export after a run to download as JSON, CSV, or Excel. Use Apify webhooks to trigger downstream workflows automatically.

Support

Open an issue on the Issues tab or contact the developer through the Apify platform.