YellowPages Scraper - US Business Leads

Disclaimer: This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Thryv, Inc. or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "YellowPages.com" is referenced only to describe the publicly available website this Actor collects data from.

Turn any trade and location into a clean list of US business leads from YellowPages.com: name, phone, e-mail address, website, full street address, opening hours, map coordinates, categories, star rating, years in business, services, payment methods, social profiles and more - one row per business, in YellowPages' own order.

Search by keyword and city or ZIP code (several of each in one run), or paste YellowPages search, category and business URLs. No login, no API key, no browser - and you pay one flat price per business, with the business-page details included.

Why this YellowPages scraper?

Data	Typical YellowPages scrapers	This actor
Name, phone, street address, city, state, ZIP, website	✅	✅
Categories, star rating, review count, years in business	partial	✅
E-mail address from the business's YellowPages page	often a paid add-on	✅ included
Opening hours per weekday + open-now status	partial	✅
Latitude / longitude	rare	✅
Description, services, brands, payment methods, languages, neighborhoods	rare	✅
Extra phone numbers (fax, toll-free), social profiles, other links	rare	✅
The business's own website kept apart from YellowPages-made listing sites	rare	✅
Results in YellowPages' order, paid placements flagged (isAd, placement)	ads often mixed in	✅
Several search terms × several cities, cap shared fairly between them	rare	✅
A business found by two searches is billed once	rare	✅
Filters: phone, website, e-mail, minimum rating, minimum reviews, no paid placements	partial	✅ (never billed for skipped rows)

What you get

Group	Fields
Identity	name, ypId, listingId, yellowPagesUrl, aka (other names)
Contact	phone, email, emails, extraPhones, fax, tollFreePhone, website, socialProfiles, otherLinks, ypMicrositeUrl
Address & location	street, city, state, postalCode, fullAddress, serviceArea, latitude, longitude, neighborhoods, locationDescription
Hours	openingHours (as YellowPages states them, e.g. Mo-Fr 08:00-17:00), hours (per weekday: e.g. 08:00-17:00, or closed), hoursText, openStatus
Classification	primaryCategory, categories, categoryCodes, servesCuisine
Reputation	rating, reviewCount, reviews (latest reviews shown on the page), tripAdvisorRating, tripAdvisorReviewCount, tripAdvisorUrl, photoCount
Profile	description, businessHistory, services, brands, paymentMethods, languages, associations, accreditation, amenities, ownership, freeEstimates, otherInformation, foundedYear, yearsInBusiness, yearsWithYellowPages, acceptedInsurance, medicalSpecialties, logoUrl, imageUrl
Listing	isClaimed, isAd, placement (organic / paid-listing / sponsored), listingType, isYpPreferred, hasCoupons, offer, slogan, snippet, isPermanentlyClosed
Search context	rank (position in YellowPages' results), page, searchTerm, searchLocation, sourceUrl, detailFetched, scrapedAt

A field the business has not filled in on YellowPages is null - exports never carry fake or placeholder values.

Use cases

• Local lead generation - every plumber, roofer, dentist, law firm or restaurant in a city, with phone, e-mail and website, ready for a CRM or a cold-calling list.
• E-mail lists for outreach - switch on "Only businesses with an e-mail address" and you are billed only for businesses that list one.
• Find businesses without a real website - website is the business's own site; a YellowPages-made listing site is reported separately as ypMicrositeUrl, so web-design agencies can spot the gap.
• Market research - how many businesses of a trade operate in each city or ZIP code, how established they are (yearsInBusiness), how they are rated and when they open.
• Data enrichment - categories, hours, coordinates and payment methods for businesses you already track, straight from their YellowPages pages.

How to use

1. Sign up for Apify - the free plan is enough to try this actor.
2. Open YellowPages Scraper, type one or more search terms and a location, and click Start.
3. Watch the businesses arrive in the dataset table (views: Businesses, Call list, E-mails & contacts, Hours & location, Business profile).
4. Export as JSON, CSV, Excel, XML or HTML, or pull the results with the Apify API.

Input

{
    "searchTerms": ["plumber", "electrician"],
    "location": "Chicago, IL; Evanston, IL",
    "maxResults": 200,
    "includeDetails": true,
    "onlyWithPhone": true
}

• searchTerms - what to look for, as you would type it into YellowPages (plumber, roofing contractor, pizza).
• location - City, ST or a 5-digit ZIP code. Several places: separate them with ;. Every search term runs in every place.
• maxResults - total businesses to collect (0 = no limit), shared fairly between all searches.
• includeDetails (default on) - open each business's YellowPages page for e-mail, hours, coordinates, description, services, links and the rest. Turn it off for a faster list with the search-result fields only.
• startUrls / urlsFromFile - YellowPages search URLs (yellowpages.com/search?search_terms=...), category pages (yellowpages.com/chicago-il/plumbers) or business pages (yellowpages.com/.../mip/...), typed in, pasted as a list or linked as a .txt / .csv file or Google Sheet.
• Filters - excludeAds, onlyWithPhone, onlyWithWebsite, onlyWithEmail, minRating, minReviews. A business that does not match is skipped and never billed.
• maxPagesPerSearch (optional) - limit how deep each search pages; leave empty and the actor pages as far as maxResults needs.

Output

{
    "type": "business",
    "name": "Lakeside Plumbing & Sewer",
    "phone": "(773) 555-0142",
    "email": "office@lakesideplumbing.example",
    "website": "https://www.lakesideplumbing.example/",
    "street": "4100 N Clark St",
    "city": "Chicago",
    "state": "IL",
    "postalCode": "60613",
    "fullAddress": "4100 N Clark St, Chicago, IL 60613",
    "primaryCategory": "Plumbers",
    "categories": ["Plumbers", "Sewer Cleaners & Repairers", "Water Heaters"],
    "rating": 4.5,
    "reviewCount": 12,
    "yearsInBusiness": 21,
    "openStatus": "open now",
    "isClaimed": true,
    "placement": "organic",
    "isAd": false,
    "ypId": "123456789",
    "yellowPagesUrl": "https://www.yellowpages.com/chicago-il/mip/lakeside-plumbing-sewer-123456789",
    "rank": 7,
    "page": 1,
    "searchTerm": "plumber",
    "searchLocation": "Chicago, IL",
    "detailFetched": true,
    "extraPhones": [{ "type": "Fax", "number": "(773) 555-0143" }],
    "latitude": 41.9571,
    "longitude": -87.6581,
    "openingHours": ["Mo-Fr 07:00-18:00", "Sa 08:00-14:00"],
    "hours": { "monday": "07:00-18:00", "tuesday": "07:00-18:00", "wednesday": "07:00-18:00", "thursday": "07:00-18:00", "friday": "07:00-18:00", "saturday": "08:00-14:00", "sunday": "closed" },
    "description": "Family-owned plumbing and sewer company serving the North Side since 2004.",
    "services": ["Drain Cleaning", "Water Heater Installation", "Sewer Repair"],
    "paymentMethods": ["visa", "master card", "check"],
    "socialProfiles": { "facebook": "https://www.facebook.com/lakesideplumbing.example" },
    "foundedYear": 2004,
    "scrapedAt": "2026-10-08T04:12:09.123Z"
}

Each run also writes an OUTPUT_SUMMARY record (key-value store) with every search, how many results YellowPages lists for it, how many pages were read and how many rows were saved.

Good to know

• E-mail addresses come from the business's own YellowPages page, so you get one only when the business lists it - roughly a third of businesses overall, more than half in trades like contractors, movers and law firms, and few restaurants or medical practices. Placeholder addresses some listings carry (such as yourname@...) and the mailboxes of website builders are dropped.
• Paid placements: YellowPages ranks its paying advertisers at the top of its own results (placement: "paid-listing") and shows sponsored ads around them (placement: "sponsored", often other trades or towns, with call-tracking phone numbers). Results arrive in YellowPages' order, sponsored ads only after a search's results run out, and isAd marks both kinds; "Exclude sponsored results" removes them all.
• Depth: YellowPages lists at most 3,000 businesses (100 pages) per search, and a city search also covers nearby towns. For more in a big metro, run the same term over several ZIP codes or neighboring cities - the actor de-duplicates businesses across searches.
• Ratings and reviews exist only where customers left them on YellowPages; most small businesses have none, and their rating is null.
• Hours are copied as YellowPages shows them; a late-night business can read 11:00-04:00 (it closes after midnight). A day YellowPages marks as closed reads closed; a day the business does not list at all is null. The Hours & location view shows one column per weekday.
• A search YellowPages cannot run (a misspelled city, for example) ends with a clear message and nothing billed.

How much does it cost to scrape YellowPages.com?

This Actor uses Apify's pay-per-event pricing: you are charged only for the results it delivers, with no monthly rental and no start fee. The events it can charge are:

• Business listing - One YellowPages business: name, phone, website, full address, categories, rating, reviews and years in business. With business page details on (the default) also its e-mail when listed, opening hours, map coordinates, description, services, payment methods and social links.

The current price of each event is shown on the Pricing tab of this page. Set a maximum total charge on the run if you want a hard cap on spend, and use the input limits to control how much the Actor fetches.

Automate & schedule

Run this Actor on autopilot and pull results into your own stack:

• Apify API - start runs, fetch datasets and manage schedules over REST.
• apify-client for JavaScript and apify-client for Python - official SDKs.
• Schedules - run it hourly, daily or weekly and keep your dataset current.
• Webhooks - trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/yellowpages-scraper').call({
    "searchTerms": [
        "plumber"
    ],
    "location": "Chicago, IL",
    "maxResults": 20,
    "maxPagesPerSearch": 1,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} records`);

Integrate with any app

Connect the dataset to thousands of apps - no code required:

• Make - multi-step automation scenarios.
• Zapier - push new records straight into your CRM or spreadsheet.
• Slack - get notified when a scheduled run finds something new.
• Google Drive / Sheets - auto-export every run to a spreadsheet.
• Airbyte - pipe results into your data warehouse.
• GitHub - trigger runs from commits or releases.

Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. You can call this Actor from Claude, ChatGPT or any agent framework through the Apify MCP server - describe the data you need and let the assistant run this Actor for you.

Agent-ready: autonomous payments (x402 & Skyfire)

This actor is agent-ready: AI agents can discover it, run it, and pay for it autonomously, with no Apify account and no human in the loop. It uses pay-per-event pricing and limited permissions, so it qualifies for Apify's agentic-payment standards:

• x402: an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the Apify MCP server, with no account and no API key.
• Skyfire: agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

Tips

• Turn off includeDetails when you only need name, phone, address and website: runs finish several times faster.
• Combine several search terms with several ZIP codes in one run - maxResults is shared fairly, so the first search never eats the whole budget.
• For e-mail campaigns use Only businesses with an e-mail address: businesses without one are skipped and cost nothing.

FAQ

How is this Actor billed? Pay-per-event: you pay only for the results it delivers, with no monthly rental and no start fee. The per-event price is shown on the Pricing tab.

Can I schedule it and get results automatically? Yes - create a Schedule and add a webhook or an integration (Google Sheets, Slack, Make, Zapier) to push each run's dataset wherever you need it.

Which export formats are available? Every run's dataset can be downloaded as JSON, CSV, Excel (XLSX), XML, HTML or RSS from the Apify Console or the API.

Can I run it from code or an AI agent? Yes - through the Apify API and client libraries, or from Claude, ChatGPT and other assistants via the Apify MCP server.

Is it legal to scrape YellowPages.com? This Actor collects publicly available data only. You are responsible for using the output in compliance with applicable laws (including data-protection law where personal data is involved) and the source's terms. See Data & lawful use and the Disclaimer below.

Is this an official YellowPages.com tool? No. It is an independent, third-party Actor with no affiliation to, endorsement by or sponsorship from Thryv, Inc. See the Disclaimer below.

Data & lawful use

This Actor reads business and professional listings that the professionals themselves published to be found: names, roles, firms, ratings and the contact details shown on the public listing. Because those details belong to identifiable people, treat the output as personal data. If you are in the EU or UK you are the data controller for what you do with it: have a lawful basis (usually legitimate interest for B2B prospecting or market research), keep any outreach relevant to the professional's line of work, honour opt-outs and deletion requests, and do not use the output for spam.

Under Apify's Standard Actor Contract, which governs your use of this Actor, you are the controller of any personal data in your input and output and scrapesage acts only as your processor: that data is processed solely to run your job, written only to your own Apify storage, never used for any other purpose and never shared onward. If you need help with a data-subject request that involves this Actor's output, open an issue on the Issues tab.

Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Thryv, Inc. or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

"YellowPages.com" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official YellowPages.com product, is not authorised or certified by Thryv, Inc., and does not distribute YellowPages.com software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

Need help?

Open an issue on the Actor's Issues tab, or visit the Apify help center. Feature requests are welcome - this Actor is actively maintained.