Yellow Pages US Scraper & API - Business Leads, Phones, Emails
Pricing
from $0.95 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
17 hours ago
Last modified
Categories
Features
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
includeDetailsthe 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, andwebsiteDomain(bare domain) for enrichment and dedupe. WithincludeDetails, Facebook and Instagram get their own columns (facebookUrl,instagramUrl). - Businesses without a website:
hasWebsite: falsemarks 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,zipas separate fields. Service-area businesses ("Serving the Charlotte area") are flagged withisServiceAreaOnly. - 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:00format), 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
ypidso 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.
| name | phone | city | website | categories | yearsInBusiness |
|---|---|---|---|---|---|
| Murr And Laney Inc | (980) 501-6075 | Pineville, NC | https://www.murrlaney.com | Roofing Contractors | 61 |
| JW Services Inc of NC | (980) 334-6603 | Concord, NC | http://jwservicesofnc.com | Roofing Contractors | 22 |
| D&W, Inc. | (704) 598-9316 | Charlotte, NC | http://dwincnc.localsearch.com | Roofing Contractors | 43 |
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 insample-output.json, a cloud run on 24 Sep 2026, are unclaimed) or nowebsite. - 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.
| Businesses | Cost |
|---|---|
| 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
- Enter one or more search terms (e.g.
plumber,dentist) and locations (e.g.Charlotte, NCor a ZIP code), or paste YellowPages search URLs. SetmaxResultsand tickincludeDetailsif you want emails. - Click Start and wait for the run to finish.
- Download your leads as JSON, CSV, Excel or HTML from the Output tab, or fetch them via the Apify API.
Input
| Field | Default | Description |
|---|---|---|
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) |
maxResults | 100 | Businesses per term x location (0 = everything YellowPages has, up to ~3,000) |
includeDetails | false | Adds email, description, hours, payment methods, services, social links, founded year, coordinates. One extra request per business. |
includeSponsored | false | Include the paid ad cards YellowPages shows above the results (often from other areas) |
proxyConfiguration | Apify Proxy | Switch 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)
| Field | Fill rate |
|---|---|
| name, phone, address, categories, YellowPages URL | 100% |
| city / state / ZIP | 98% (the rest are service-area businesses) |
| website | 94% |
| opening hours | 86% |
| review snippet | 83% |
| years in business | 57% |
| YellowPages rating + review count | 46% (only businesses that have YP reviews) |
| TripAdvisor rating | 0% 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-itemswith headerAuthorization: Bearer <token>and your input as the JSON body) > Google Sheets "Append or update row" matched onypid. 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=csvorjson):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
includeDetailsand 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). ForincludeDetailsruns 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 withdetailsError), 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 installnpm test # parser tests on saved fixturesnode 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