Yellow Pages US Scraper & API - Business Leads, Phones, Emails avatar

Yellow Pages US Scraper & API - Business Leads, Phones, Emails

Pricing

from $0.95 / 1,000 results

Go to Apify Store
Yellow Pages US Scraper & API - Business Leads, Phones, Emails

Yellow Pages US Scraper & API - Business Leads, Phones, Emails

Input: keywords (e.g. plumber) and US cities or ZIPs, or YellowPages search URLs. Output: one row per business: name, phone, address, website, categories, rating, hours, years in business; optional email, socials and GPS. Detail pages included. $0.95 per 1,000 results.

Pricing

from $0.95 / 1,000 results

Rating

0.0

(0)

Developer

Giovanni Rich

Giovanni Rich

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

17 hours ago

Last modified

Categories

Features

Limited permissions

Share

This Yellow Pages scraper turns any YellowPages.com search into a clean US business leads list: business name, phone number, full street address (split into street / city / state / ZIP), website, categories, ratings, opening hours and years in business. Turn on includeDetails to also get business emails (when listed), description, payment methods, services, social links and GPS coordinates - a simple YellowPages API for lead generation and local business data.

Search any keyword in any number of US cities in one run: ["plumber", "roofer"] x ["Charlotte, NC", "Austin, TX", "10001"]. It runs over plain HTTP with no headless browser, rotates proxy sessions automatically when YellowPages' Cloudflare edge pushes back, and fetches result pages in parallel. $0.95 per 1,000 businesses, detail pages (emails, socials) included.

What you get

  • Contact: phone, website, full address, and with includeDetails the email address, extra phone/fax numbers and social links (Facebook, Instagram, ...).
  • CRM and dialer ready: phoneE164 (+17042519995 format) for dialers, SMS tools and CRM imports, and websiteDomain (bare domain) for enrichment and dedupe. With includeDetails, Facebook and Instagram get their own columns (facebookUrl, instagramUrl).
  • Businesses without a website: hasWebsite: false marks every listing with no site, the classic lead list for web-design, SEO and Google Business Profile agencies. Filter on it in the Output tab or in your sheet.
  • Address split for CRMs: street, city, state, zip as separate fields. Service-area businesses ("Serving the Charlotte area") are flagged with isServiceAreaOnly.
  • Reputation: YellowPages star rating and review count, TripAdvisor rating and review count (restaurants, hotels, attractions), price range.
  • Business profile: categories, opening hours (Mo-Fr 08:00-17:00 format), open-now status, years in business, years on YellowPages, claimed/unclaimed listing, review snippet, thumbnail, the business's own slogan (e.g. "We Deliver!") and amenities for restaurants and venues ("Good for families", "Wheelchair accessible", "Serves alcohol").
  • IDs and links: YellowPages URL and ypid so you can dedupe and track the same business over time.
  • Pagination: 30 listings per page, pages fetched in parallel until maxResults. Duplicates are removed.

Sample output

From a real cloud run on 24 Sep 2026 with details on (scripts/cloud-details-dc.json): "roofing contractors" in Charlotte, NC.

namephonecitywebsitecategoriesyearsInBusiness
Murr And Laney Inc(980) 501-6075Pineville, NChttps://www.murrlaney.comRoofing Contractors61
JW Services Inc of NC(980) 334-6603Concord, NChttp://jwservicesofnc.comRoofing Contractors22
D&W, Inc.(704) 598-9316Charlotte, NChttp://dwincnc.localsearch.comRoofing Contractors43

Use cases

  • Cold outreach and lead generation for agencies, SaaS and B2B sales (local service businesses: contractors, dentists, lawyers, restaurants, salons, ...)
  • Market sizing: how many plumbers / dentists / gyms are in a city, and how established they are
  • Enriching a CRM with phone, address, website and category
  • Finding businesses without a website or with an unclaimed listing (great prospects for web and marketing agencies)
  • Building local directories or territory lists by ZIP code for field sales teams
  • Local SEO and listing-management prospects: filter isClaimed: false (199 of the 256 rows in sample-output.json, a cloud run on 24 Sep 2026, are unclaimed) or no website.
  • Weekly territory feeds into Google Sheets or a CRM via Make, n8n or Zapier, deduped on ypid.

Pricing

$0.95 per 1,000 results (pay per result; failed requests are never charged), plus Apify's $0.00005 start fee. Detail pages (emails, socials, payment, coordinates) are included at the same price, with no separate "email" or "bypass" event. Apify's platform usage is included in that price. Other US Yellow Pages actors on the free plan (live Apify Store search, 16 Nov 2026; 30-day users where more than 1): delicious_zebu (30) $3.00 + $0.00005 start, automation-lab (7) $3.00 + $0.01 start, hipersoft $3.00 + $0.00005 start, memo23 (4) $2.50 + $0.005 start ($2.00 per 1,000 phones, $50.00 per 1,000 emails), mamies (2) $2.50 ($4.00 with email), juanoox $2.00 + $0.001 start, growthscrapers $2.00 + $0.00005 start, tortuga $2.00 ($3.00 per 1,000 details), seemuapps $1.50 ($8.00 with details), giga_data $1.50 + $0.00005 start, tagadanar (3) $1.50 + $0.001 start, bgfc97 (2) $1.50, axlymxp $1.50 + $0.01 start, maximedupre $1.05, webdatatools $1.00 + $0.00005 start, b2b_leads $1.00 + $0.00005 start, technicaldost $1.00, jeffev $1.00 ($3.00 with details), datascraperes $1.00 (+ $0.50 per 1,000 reviews), fatihtahta $0.99, solidcode (20) $0.96 (listing data), wildorigins (6) $0.80 + $3.00 per 1,000 "bypass" events, karamelo (4) $0.70, rbbscrap $0.70, scrapersdelight $0.63 + $0.18 per 1,000 details, dami_studio $0.60 + $0.001 start + $3.10 per 1,000 requests, kaix (2) $0.10 + $0.00005 start + $0.04 per 1,000 reviews; cirkit is free. Since 15 Nov 2026 this one costs less than solidcode, the most-used actor under $1.50, with the detail page included; several smaller ones (wildorigins, karamelo, rbbscrap, scrapersdelight, dami_studio, kaix, cirkit) are still cheaper per row, so this is not the lowest price.

BusinessesCost
100$0.095
1,000$0.95
10,000$9.50

Apify's free plan ($5 of monthly credit) covers about 5,200 businesses a month.

FAQ

Is it legal to scrape YellowPages? This actor only collects publicly listed business information. Some listings include names or emails of sole proprietors; you're responsible for using the data in line with YellowPages' terms and privacy and anti-spam laws (e.g. CAN-SPAM, GDPR, CCPA). This is not legal advice - if you're unsure, check with a lawyer.

Does it need a login or a browser? No login, no API key, no browser. It makes plain HTTPS requests and reads the listing HTML and the schema.org data YellowPages embeds.

How fast is it and how many results can I get? A cloud run with includeDetails on 4 Nov 2026 (6 searches, 80 businesses) took 343 seconds, about 4 seconds per business including Cloudflare retries, and one on 6 Nov 2026 (6 searches, 61 businesses) took 232 seconds; without details it opens far fewer pages. Each search returns up to ~3,000 businesses (about 100 pages of 30); for a whole metro area, split by suburb or ZIP code. includeDetails adds one extra request per business, so it is slower.

Which proxy should I use? Start with the default Apify Proxy. When a page stays blocked after a few datacenter attempts, the retry moves to the RESIDENTIAL (US) proxy group on its own (when your account has it). For big or includeDetails runs you can start on RESIDENTIAL (US) directly. Unknown locations, bad URLs or a search that stays blocked never fail the run: it finishes with what it got, and the status message and RUN_SUMMARY explain each search.

Can I schedule it or call it via API? Yes. Use Apify Schedules for daily/weekly runs, or start it from the Apify API, the JavaScript/Python clients, Make, Zapier, n8n or the Apify MCP server for AI agents.

Why did a search return fewer results than maxResults? YellowPages had fewer listings for that term and location, or a page gave up after all retries. The RUN_SUMMARY record in the key-value store shows, per search, how many results YellowPages reports, how many were collected and why it stopped.

Can I use my own filters or sorting? Yes: set them on yellowpages.com, copy the search URL and paste it into startUrls.

Does YellowPages have an official API? No public one: YellowPages.com does not offer a self-serve search API. This actor returns the same public listings as JSON, CSV or Excel through the Apify API.

How much does a typical job cost? One trade in 20 cities at 100 businesses each (2,000 leads) costs $1.90. A weekly run of 3 trades x 10 ZIP codes x 50 is about 6,500 leads a month, about $6.18.

Example inputs for common jobs

Copy one into the JSON tab of the input form.

Contractor leads in two metros

{
"searchTerms": ["plumber", "hvac contractor", "roofing contractors"],
"locations": ["Austin, TX", "Denver, CO"],
"maxResults": 200
}

Leads with emails (slower: one page per business, use RESIDENTIAL proxy)

{
"searchTerms": ["dentist"],
"locations": ["Charlotte, NC"],
"maxResults": 100,
"includeDetails": true,
"proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

Full coverage of a city, split by ZIP code

{
"searchTerms": ["restaurants"],
"locations": ["10001", "10002", "10003", "10011"],
"maxResults": 0
}

Re-run a search you set up on yellowpages.com (keeps its filters)

{
"startUrls": [{ "url": "https://www.yellowpages.com/search?search_terms=electrician&geo_location_terms=Charlotte%2C+NC" }],
"maxResults": 300
}

How to use

  1. Enter one or more search terms (e.g. plumber, dentist) and locations (e.g. Charlotte, NC or a ZIP code), or paste YellowPages search URLs. Set maxResults and tick includeDetails if you want emails.
  2. Click Start and wait for the run to finish.
  3. Download your leads as JSON, CSV, Excel or HTML from the Output tab, or fetch them via the Apify API.

Input

FieldDefaultDescription
searchTerms-What you'd type into the YellowPages "Find" box: "plumber", "dentist", "pizza"
locations-US city + state or ZIP: "Charlotte, NC", "Austin, TX", "10001". Every term is searched in every location.
startUrls-Optional: paste YellowPages search URLs directly (keeps any sorting/filters you set on the site)
maxResults100Businesses per term x location (0 = everything YellowPages has, up to ~3,000)
includeDetailsfalseAdds email, description, hours, payment methods, services, social links, founded year, coordinates. One extra request per business.
includeSponsoredfalseInclude the paid ad cards YellowPages shows above the results (often from other areas)
proxyConfigurationApify ProxySwitch to RESIDENTIAL (US) if you see many blocks

Input example

{
"searchTerms": ["plumber", "hvac contractor"],
"locations": ["Charlotte, NC", "Austin, TX"],
"maxResults": 200,
"includeDetails": true
}

Output example

One dataset item per business. This one is from a real cloud run: "roofing contractors" in Charlotte, NC with includeDetails: true (long text shortened).

{
"searchTerm": "roofing contractors",
"location": "Charlotte, NC",
"position": 5,
"name": "Roofing Contractors of America",
"ypid": "520015737",
"categories": ["Roofing Contractors", "General Contractors", "Fire & Water Damage Restoration"],
"rating": 5,
"reviewCount": 4,
"tripAdvisorRating": null,
"tripAdvisorReviewCount": null,
"priceRange": null,
"phone": "(844) 251-9995",
"address": "10130 Perimeter Pkwy, Charlotte, NC 28216",
"street": "10130 Perimeter Pkwy",
"city": "Charlotte",
"state": "NC",
"zip": "28216",
"website": "http://roofingcontractorsofamerica.localsearch.com",
"yellowPagesUrl": "https://www.yellowpages.com/charlotte-nc/mip/roofing-contractors-of-america-520015737?lid=1001643842969",
"openingHours": ["Mo-Su"],
"openStatus": "open 24 hours",
"yearsInBusiness": null,
"yearsWithYellowPages": null,
"snippet": "I just want to see that I had my hesitations about getting my roof done... RCA was amazing.",
"thumbnail": "https://i4.ypcdn.com/blob/fbe8d98e053d2241e122b33a51931e5458eef6e6_130x130_crop.jpg",
"isServiceAreaOnly": false,
"isSponsored": false,
"isClaimed": true,
"searchPage": 1,
"scrapedAt": "2026-09-24T05:30:26.958Z",
"email": "admin@rcacarolina.com",
"description": "What we Promise? One thing is for sure that when we will finish the restoration, you will be surprised to see your home or office...",
"paymentMethods": ["check", "financing available", "insurance", "amex", "visa", "discover", "mastercard", "debit"],
"foundedYear": null,
"latitude": 35.347534,
"longitude": -80.85175,
"services": ["Storm Damage, Fire Damage, Water Damage, Mold Remediation, Roof Repair, ..."],
"socialLinks": ["https://www.facebook.com/RCACarolina/", "https://twitter.com/RCACarolinas", "https://www.instagram.com/rcacarolina/"],
"extraPhones": ["Phone: (704) 251-9995"],
"aka": null,
"image": "https://i4.ypcdn.com/blob/fbe8d98e053d2241e122b33a51931e5458eef6e6",
"phoneE164": "+18442519995",
"websiteDomain": "roofingcontractorsofamerica.localsearch.com",
"hasWebsite": true,
"facebookUrl": "https://www.facebook.com/RCACarolina/",
"instagramUrl": "https://www.instagram.com/rcacarolina/"
}

Restaurants also get tripAdvisorRating / tripAdvisorReviewCount (e.g. a Chicago pizza place: 4.5 from 2,387 TripAdvisor reviews).

The dataset has two ready-made views: Overview (photo, name, phone, address, website, email, categories, rating) and Contacts (CRM export) (flat name / phone / email / website / street / city / state / ZIP).

Field fill rates (real cloud run: 235 businesses, dentists and plumbers in Denver and Austin)

FieldFill rate
name, phone, address, categories, YellowPages URL100%
city / state / ZIP98% (the rest are service-area businesses)
website94%
opening hours86%
review snippet83%
years in business57%
YellowPages rating + review count46% (only businesses that have YP reviews)
TripAdvisor rating0% for trades; ~60% for restaurants

With includeDetails (21 detail pages): email 57%, payment methods 86%, hours 95%, description / coordinates 81%, founded year 76%, social links 38%.

A 2026-10-29 local run (10 pizza places in New York, with details): hasWebsite 10/10 filled (1 business has no website), email 4/10, slogan 1/10, amenities 1/10. On the SuperPages fixture page (30 pizza places) amenities are on 5 of 30 and slogans on 1.

Integrations

  • Google Sheets: download the run as CSV or Excel from the Output tab, or send every run to a sheet with Make, n8n or Zapier (below). Useful columns: name, phoneE164, street, city, state, zip, website, websiteDomain, categories, isClaimed, email.
  • Make: Apify app > "Run an Actor" (actor rel8ble/yellowpages-scraper, wait for finish on) > "Get Dataset Items" > Google Sheets, Airtable or your CRM.
  • n8n: Schedule Trigger > HTTP Request (POST https://api.apify.com/v2/acts/rel8ble~yellowpages-scraper/run-sync-get-dataset-items with header Authorization: Bearer <token> and your input as the JSON body) > Google Sheets "Append or update row" matched on ypid. The official Apify node (@apify/n8n-nodes-apify) works too. A ready-to-import workflow is in the GitHub repo below.
  • Zapier: Apify app > "Run Actor" action, or the "Finished Actor Run" trigger on a scheduled run > "Fetch Dataset Items".
  • API: one call runs the actor and returns the data (?format=csv or json): curl -X POST "https://api.apify.com/v2/acts/rel8ble~yellowpages-scraper/run-sync-get-dataset-items?format=csv" -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" -H "Content-Type: application/json" -d '<input JSON>' or use the official Python and JavaScript clients (apify-client).
  • Schedules and webhooks: run it daily or weekly from Apify Schedules, and get a webhook when a run finishes.
  • MCP for AI agents: the Apify MCP server (https://mcp.apify.com) lets Claude, ChatGPT, Cursor and other agents call this actor as a tool.

Limits (read before large runs)

  • United States only. YellowPages.com covers US businesses. (Canada, Australia and other countries have separate Yellow Pages sites that this actor does not cover.)
  • Up to ~3,000 results per search (YellowPages serves at most ~100 pages of 30). For a whole metro area, split by suburb or ZIP code.
  • Email needs includeDetails and only exists when the business published one on YellowPages. Detail mode opens one extra page per business, so it's slower and uses more proxy traffic.
  • Cloudflare: YellowPages sits behind Cloudflare and challenges a large share of automated requests. The scraper uses the client profile that passes most often and retries challenged pages on a fresh proxy session automatically. In the 6 Nov 2026 cloud run with includeDetails (6 searches), all 6 search pages got through after retries and 49 of 61 detail pages loaded (datacenter first, then residential; residential pages were blocked at times too). For includeDetails runs or big jobs, you can start on the RESIDENTIAL proxy group to skip the datacenter attempts. A detail page that still fails is saved without the extra fields (marked with detailsError), so you never lose the listing.
  • Review texts are not included in this version (only the snippet shown on the results page).

How it works (for developers)

Each search page is fetched over HTTP with a desktop browser fingerprint and parsed with Cheerio: the result cards give name, phone, address, categories, ratings and badges, and the page's schema.org LocalBusiness JSON-LD adds structured address parts and opening hours. The total result count on page 1 is used to fan out the remaining page URLs in parallel. Detail pages are read from their schema.org JSON-LD (email, geo, payment, services, hours) with HTML fallbacks, including decoding Cloudflare-obfuscated email links. Blocked responses (403/429/challenge pages) retire the session and retry on a new proxy IP.

Run it locally:

npm install
npm test # parser tests on saved fixtures
node src/main.js # input in storage/key_value_stores/default/INPUT.json

Need a custom scraper or a ready dataset? Hire me on Fiverr: https://www.fiverr.com/rel8ble