Yellow Pages Business Scraper

Scrape Yellow Pages business listings by category and city or ZIP code. This Yellow Pages scraper returns business name, phone, full address with latitude and longitude, website, opening hours, social media links, accepted payment methods, years in business, star rating, and review count.

No Yellow Pages API key, no login, and no headless browser. Results land in a structured dataset you can export to JSON, CSV, Excel, or XML, or pull straight from the Apify API.

What is Yellow Pages Business Scraper?

Yellow Pages Business Scraper is an Apify Actor that extracts business directory listings from Yellow Pages and returns them as clean, structured records. Years in business and payment methods are fields most local-data sources simply do not carry, and both are genuinely useful for qualifying a B2B prospect list.

What data can this Yellow Pages scraper extract?

Every run writes one row per business. The full schema carries 24 fields; the most-used ones are below.

Field	Type	Description
yellowPagesId	string	Stable canonical YP business identifier (the 8-9 digit ypid at the end of the MIP URL). Null on warning rows when...
name	string	Primary business name as listed on Yellow Pages. Null on warning rows.
phone	string	Dialable phone in E.164 form when possible, e.g. +15127660970.
website	string	External business website. Populated by detail-page enrichment when present.
address	string	Single-line full address composed from the address components.
streetAddress	string	Street number and street name only.
city	string	Address locality.
state	string	Two-letter US state code.
postalCode	string	US ZIP or ZIP+4.
country	string	ISO country code; almost always US.
latitude	number	Decimal degrees. Populated by detail enrichment only.
longitude	number	Decimal degrees. Populated by detail enrichment only.
categories	array	Yellow Pages category labels for this business.
yearsInBusiness	integer	Years the business reports operating. Populated by detail enrichment.
rating	number	0.0 to 5.0 average from Yellow Pages aggregated reviews.
reviewCount	integer	Number of reviews on Yellow Pages.
hours	object	Mapping of weekday (mon..sun) to opening hours string (e.g. '09:00-17:00').
paymentAccepted	array	List of accepted payment methods (amex, discover, master card, visa, etc.).
socialLinks	object	Object with one nullable string per platform: facebook, instagram, twitter, linkedin, youtube.
mipUrl	string	Canonical Yellow Pages business detail page URL (MIP). Null on warning rows.
warning	string	Set to a short marker like 'no_results' on synthetic rows the actor emits when a search legitimately yields no...
warningMessage	string	Human-readable explanation for a warning row.

See the Output tab in Apify Console for all 24 fields.

How to scrape Yellow Pages business listings

1. Open Yellow Pages Business Scraper and click Try for free.
2. Add categories or keywords to searchTerms.
3. Set geoLocation to a city, state, or ZIP code.
4. Turn on scrapeDetails for hours, socials, and payment methods.
5. Set maxResults and pages to bound the run.
6. Click Start and watch rows appear live in the Output tab.
7. Export the dataset as JSON, CSV, Excel, or XML — or fetch it from the Apify API once the run finishes.

Yellow Pages Business Scraper input options

Input	Type	What it does	Default
searchTerms	string	Business category or keyword to search (e.g. 'plumber', 'dentist', 'pizza').	yes
geoLocation	string	Location filter. Accepts city + state ('Austin, TX'), ZIP code, or neighborhood.	yes
maxResults	integer	Hard cap on the number of business records returned. Yellow Pages returns roughly 30 results per page; the scraper...	20
pages	integer	Alternative cap by page count. If set, scraper stops after this many search pages even if maxResults is not reached....
scrapeDetails	boolean	When true, the scraper hits each business's detail page to pull lat/lng, hours, website, social links, payment...	true

Proxy is configured through the standard proxyConfiguration object; the defaults shipped with this Actor are already tuned for the target site.

Example output

{
  "yellowPagesId": "10674347",
  "name": "Clarke Kent Plumbing",
  "phone": "+15127660970",
  "website": "http://www.clarkekentplumbing.com",
  "address": "1408 W Ben White Blvd, Austin, TX 78704",
  "streetAddress": "1408 W Ben White Blvd",
  "city": "Austin",
  "state": "TX",
  "postalCode": "78704",
  "country": "US",
  "latitude": 30.228342,
  "longitude": -97.78136,
  "categories": ["Plumbers", "Plumbing-Drain & Sewer Cleaning"],
  "yearsInBusiness": 40,
  "rating": 3.0,
  "reviewCount": 15,
  "hours": {
    "mon": "09:00-17:00",
    "tue": "09:00-17:00",
    "wed": "09:00-17:00",
    "thu": "09:00-17:00",
    "fri": "09:00-17:00"
  },
  "paymentAccepted": ["check", "amex", "discover", "visa", "cash", "master card"],
  "socialLinks": {
    "facebook": "https://www.facebook.com/Clarke-Kent-Plumbing-Inc-140942559358301/",
    "instagram": "https://www.instagram.com/clarkekentplumbing/",
    "twitter": "https://twitter.com/CKPlumingInc",
    "linkedin": "https://www.linkedin.com/company/clarke-kent-plumbing",
    "youtube": null
  },
  "mipUrl": "https://www.yellowpages.com/austin-tx/mip/clarke-kent-plumbing-10674347",
  "searchQuery": {
    "searchTerms": "plumber",
    "geoLocation": "Austin, TX",
    "page": 1
  },
  "scrapedAt": "2026-05-25T01:33:08+00:00"
}

How much does it cost to scrape Yellow Pages?

This Actor bills through Apify platform usage (compute units and proxy traffic) rather than a per-result fee. Runs are HTTP-based and lightweight, which keeps compute low. Every Apify account includes free monthly usage credit to trial it.

What can you build with Yellow Pages data?

Build B2B lead lists with firmographics

yearsInBusiness is an unusually good qualifier — it separates established operators from brand-new businesses before you spend anything on outreach.

Find businesses missing a web presence

Listings without a website value are the clearest prospects for web design and digital marketing services.

Enrich records with social profiles

socialLinks gives you the business's own social accounts, which are a warmer outreach channel than a cold call.

Cross-verify data from other directories

Running the same category through Yellow Pages, Yelp, and Google Maps and reconciling the results produces a far more accurate local dataset than any single source.

Map local market composition

Coordinates and categories across a metro show how business types cluster geographically.

Yellow Pages scraping tips and limits

• The parser reads JSON-LD first, which is why address and hours come back structured rather than as scraped text fragments.
• scrapeDetails adds a request per business. Run it off for a fast census, on when you need contact depth.
• Yellow Pages coverage is strongest for traditional service trades — contractors, legal, medical, automotive. For restaurants and retail, Yelp or Google Maps will cover more.
• Always cross-check phone numbers against a second source before a large outbound campaign; directory data goes stale.

Integrations and automation

Run Yellow Pages Business Scraper on a schedule to keep a Yellow Pages dataset fresh, or trigger it from your own stack through the Apify API and the official JavaScript and Python clients. Native integrations push results into Google Sheets, Slack, Airtable, Zapier, Make, GitHub, or any webhook endpoint. The Actor also works as an MCP tool, so an AI agent can call it directly.

Related scrapers

Actor	What it does
Google Maps Business Scraper	The largest local business dataset, with place IDs.
Yelp Business Scraper	Yelp records with attributes, photos, and claimed status.
Healthgrades Provider Search Scraper	Healthcare providers with insurance and coordinates.
Realtor.com Agent Leads Scraper	Real-estate agents with licences and brokerages.

Frequently asked questions

How is this different from a Yelp or Google Maps scraper?

Yellow Pages carries fields the others do not — years in business, accepted payment methods, and direct social links. Its coverage skews toward service trades. Most serious local datasets combine all three.

Can I search by ZIP code?

Yes. geoLocation accepts a city, a state, or a ZIP code, and ZIP-level searches are the best way to get even coverage across a metro.

Do I need a Yellow Pages API key?

No. Yellow Pages Business Scraper reads publicly available Yellow Pages pages and endpoints directly, so there is no key to obtain, no OAuth app to register, and no account to connect.

Can I export Yellow Pages data to CSV, Excel, or Google Sheets?

Yes. Every run stores results in an Apify dataset that exports to JSON, JSONL, CSV, Excel, XML, or HTML with one click, and the Google Sheets integration writes rows straight into a spreadsheet.

Can I run Yellow Pages Business Scraper on a schedule?

Yes. Apify schedules run the Actor hourly, daily, weekly, or on any cron expression, and webhooks can notify your systems the moment a run finishes.

Is it legal to scrape Yellow Pages?

Scraping publicly available data is broadly lawful in the US and EU, but the answer depends on what you collect and how you use it. This Actor is built to gather public business directory information about commercial entities rather than data about private individuals. Personal data carries extra obligations under GDPR and CCPA. Read Apify's guide on whether web scraping is legal and take your own legal advice for your use case.

Support and feedback

Found a bug, a missing field, or a Yellow Pages page shape this Actor does not handle yet? Open an issue from the Issues tab on the Actor page. Feature requests and custom-scraper enquiries are welcome there too.