Yellow Pages US Scraper

Pull business listings from Yellow Pages at scale — names, verified phone numbers, websites, emails, full street addresses with lat/lng, day-of-week hours, services, payment methods, BBB accreditation, claimed status, social handles, photos, and optional customer reviews for any keyword or category in any of the 50 US states. Built for sales teams, lead-gen agencies, local-SEO analysts, recruiters sourcing trades, and franchise operators who need a structured, deduplicated US business directory without wrestling with Yellow Pages' HTML one page at a time.

Why This Scraper?

• 28 fields per business (29 with reviews enabled) — verified phone, website, email, lat/lng coordinates, day-by-day hours, services, payment methods accepted, BBB accreditation flag, owner-claimed flag, years-in-business, and Facebook / Twitter / Instagram / LinkedIn / YouTube links — all on a single flat row.
• Built-in client reviews — flip includeReviews on and the row arrives with up to 2,000 reviews per business (reviewer name, 1–5 rating, ISO date, title, body, owner response). Most competing Yellow Pages scrapers omit reviews entirely.
• Three input shapes in one actor — keyword + location, a Yellow Pages category URL like /los-angeles-ca/restaurants, or a direct business-profile URL. Mix all three in a single run.
• Cross-join searches — pass ["plumbers", "electricians"] × ["Brooklyn, NY", "Queens, NY"] and the actor automatically runs all 4 combinations in one job.
• Coverage of every US state and Yellow Pages category — search any city, "City, ST", or 5-digit ZIP across all 50 states; no per-state setup, no hand-crafted URLs.
• Four sort modes — Best Match, Distance, Name (A–Z), or Highest Rated. Pull the top-rated 5 plumbers in any ZIP in a single call.
• Hours structured by weekday — {"Mon": "9:00 AM - 5:00 PM", "Tue": ...} instead of raw text. Drop straight into a CRM, dashboard, or lead-routing rule.
• Owner-claimed status, BBB accreditation, and years-in-business — three trust signals competing scrapers consistently omit, but invaluable for B2B outreach scoring and franchise / acquisition research.

Use Cases

Lead Generation & Sales

• Build targeted prospect lists of local SMBs by category and ZIP
• Pull every plumber, dentist, or HVAC contractor in a metro for cold outreach
• Filter for claimed: false to find owners who haven't verified their listing — high-intent agency / SaaS pitch
• Capture Facebook, LinkedIn, and Instagram handles for multi-channel campaigns

Market Research & Competitive Intelligence

• Map local SMB density by category across cities, ZIPs, or whole states
• Compare review-volume and rating distributions across markets
• Track years-in-business to identify mature vs. emerging local markets
• Benchmark service offerings and payment methods within a category

Local SEO & Reputation Management

• Audit a client's Yellow Pages listing against top-ranked competitors in their ZIP
• Pull aggregate ratings + review counts for share-of-voice reporting
• Sort by Highest Rated to identify reputation leaders to study
• Monitor BBB accreditation across a competitor set

Recruiting & Talent Sourcing

• Source contact details for trades businesses (electricians, plumbers, contractors) when filling skilled-trade roles
• Build employer lists by category for outbound recruiting
• Identify multi-location operators by name + address dedupe

Franchise Development & Site Selection

• Count competitor density before opening a new location
• Find under-served categories within a ZIP or city
• Pull operating hours to size labor shifts in target markets

Data Enrichment & Integration

• Append verified phone, website, and lat/lng to an existing local business database
• Power a "find a local provider" feature with fresh, structured listings
• Feed a directory product, comparison site, or local-services marketplace

Getting Started

Simple Search

The fastest way to start — one keyword and one location:

{
    "searchTerms": ["plumbers"],
    "locations": ["Brooklyn, NY"],
    "maxResults": 50
}

Browse a Category Page

Skip the search step and crawl an entire Yellow Pages category page directly:

{
    "startUrls": [
        "https://www.yellowpages.com/los-angeles-ca/restaurants"
    ],
    "sortBy": "rating",
    "maxResults": 200
}

Full Profile + Reviews

Pull a single business profile with up to 100 customer reviews embedded:

{
    "startUrls": [
        "https://www.yellowpages.com/new-york-ny/mip/joes-pizza-12345678"
    ],
    "includeReviews": true,
    "maxReviewsPerBusiness": 100
}

Cross-Join Multi-Market Run

Two keywords across three metros = six searches automatically:

{
    "searchTerms": ["plumbers", "electricians"],
    "locations": ["Brooklyn, NY", "Queens, NY", "Manhattan, NY"],
    "sortBy": "rating",
    "includeReviews": true,
    "maxReviewsPerBusiness": 30,
    "maxResults": 1000
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
searchTerms	string[]	["plumbers"]	Keywords or business categories (e.g. plumbers, dentists, pizza). Cross-joined with locations.
locations	string[]	["Los Angeles, CA"]	Cities, "City, ST", or 5-digit US ZIPs (e.g. 90210, Brooklyn, NY). Cross-joined with searchTerms.
startUrls	string[]	[]	Paste Yellow Pages URLs directly. Search results, category pages, or individual business profiles all work — the actor auto-detects the type. Filters in the URL are honored.

Filters

Parameter	Type	Default	Description
sortBy	select	Best Match (Yellow Pages default)	Order results by Best Match, Distance, Name (A-Z), or Highest Rated. Applied to keyword searches and category URLs (ignored for single-profile URLs).

Output Options

Parameter	Type	Default	Description
includeReviews	boolean	false	Embed each business's customer reviews on its row. Off by default — turning it on adds extra page fetches per business.
maxReviewsPerBusiness	integer	30	Cap on reviews per business when includeReviews is on (newest first). Set 0 to capture all available reviews up to an internal hard cap of ~2,000. Ignored when reviews are off.

Limits

Parameter	Type	Default	Description
maxResults	integer	100	Hard cap on total business rows across every search and URL. Set 0 for no cap (an internal upper limit of 100,000 still applies). The actor stops requesting new pages once the cap is reached but keeps the full final page even if it slightly overshoots.

Output

Each business is a single flat row. Here's a representative example with reviews enabled:

{
    "name": "Joe's Pizza",
    "profileUrl": "https://www.yellowpages.com/new-york-ny/mip/joes-pizza-12345678",
    "yellowPagesId": "12345678",
    "categories": ["Pizza", "Italian Restaurants", "Take Out Restaurants"],
    "primaryCategory": "Pizza",
    "phone": "(212) 555-0142",
    "website": "https://joespizzanyc.com",
    "email": "info@joespizzanyc.com",
    "address": {
        "street": "7 Carmine St",
        "city": "New York",
        "state": "NY",
        "postalCode": "10014",
        "country": "US"
    },
    "addressFormatted": "7 Carmine St, New York, NY, 10014",
    "coordinates": { "latitude": 40.7308, "longitude": -74.0027 },
    "rating": 4.6,
    "reviewCount": 1842,
    "yearsInBusiness": 47,
    "claimed": true,
    "bbbAccredited": false,
    "hours": {
        "Mon": "10:00 AM - 4:00 AM",
        "Tue": "10:00 AM - 4:00 AM",
        "Wed": "10:00 AM - 4:00 AM",
        "Thu": "10:00 AM - 4:00 AM",
        "Fri": "10:00 AM - 5:00 AM",
        "Sat": "10:00 AM - 5:00 AM",
        "Sun": "11:00 AM - 4:00 AM"
    },
    "services": ["Cheese Slices", "Sicilian Pies", "Catering"],
    "paymentMethods": ["Visa", "Mastercard", "Amex", "Cash"],
    "description": "Family-owned pizzeria serving classic New York-style slices since 1975.",
    "tagline": "A Slice of New York History",
    "photos": [
        "https://images.yellowpages.com/photos/joes-1.jpg",
        "https://images.yellowpages.com/photos/joes-2.jpg"
    ],
    "logo": "https://images.yellowpages.com/logos/joes.jpg",
    "socialLinks": {
        "facebook": "https://www.facebook.com/joespizzanyc",
        "twitter": "https://twitter.com/joespizzanyc",
        "instagram": "https://www.instagram.com/joespizzanyc",
        "linkedin": null,
        "youtube": null
    },
    "searchTerm": "pizza",
    "searchLocation": "New York, NY",
    "sourceUrl": "https://www.yellowpages.com/search?search_terms=pizza&geo_location_terms=New+York%2C+NY",
    "reviews": [
        {
            "author": "Maria L.",
            "rating": 5,
            "date": "2025-12-14",
            "title": "Best slice in the city",
            "body": "Crisp crust, tangy sauce, exactly the slice my grandfather used to take me for. Worth the line.",
            "response": null
        }
    ],
    "scrapedAt": "2026-05-09T14:30:00Z"
}

Core Identity

Field	Type	Description
name	string	Business name
profileUrl	string	Direct Yellow Pages profile URL
yellowPagesId	string	Yellow Pages internal business ID
primaryCategory	string	Top category (e.g. Pizza)
categories	string[]	All categories the business is listed under
tagline	string	Business slogan if listed
description	string	Full business description / general info

Contact

Field	Type	Description
phone	string	Primary phone number
website	string	Business website URL
email	string	Public contact email when published
socialLinks	object	facebook, twitter, instagram, linkedin, youtube URLs (null when absent)

Address & Location

Field	Type	Description
address	object	Structured street, city, state, postalCode, country
addressFormatted	string	One-line formatted address
coordinates	object	{ latitude, longitude } from the listing's geo data

Trust & Business Signals

Field	Type	Description
rating	number	Aggregate star rating (1.0–5.0)
reviewCount	number	Total review count
yearsInBusiness	number	Reported years operating
claimed	boolean	true when the owner has verified the listing
bbbAccredited	boolean	true when accredited by the Better Business Bureau
paymentMethods	string[]	Accepted payment methods (e.g. Visa, Mastercard, Cash)

Schedule & Services

Field	Type	Description
hours	object	Weekday-keyed hours, e.g. { "Mon": "9:00 AM - 5:00 PM" }
services	string[]	Specific services / products offered

Media

Field	Type	Description
logo	string	Business logo URL
photos	string[]	Profile photo URLs

Run Context

Field	Type	Description
searchTerm	string	Term that produced this row (null for direct profile URLs)
searchLocation	string	Location that produced this row
sourceUrl	string	Yellow Pages URL the row was extracted from
scrapedAt	string	ISO 8601 timestamp of extraction

Reviews (when includeReviews is on)

Field	Type	Description
reviews	object[]	Array of review objects, newest first
reviews[].author	string	Reviewer display name
reviews[].rating	number	1–5 star rating
reviews[].date	string	ISO date
reviews[].title	string	Review title / headline
reviews[].body	string	Full review text
reviews[].response	string | object	Owner response when present

Tips for Best Results

• City + state beats ZIP-only — "Brooklyn, NY" returns more accurate matches than "11201". ZIP-only searches still work but Yellow Pages may broaden them to the surrounding metro.
• Use category URLs for exhaustive scrapes — pasting a category URL like /los-angeles-ca/restaurants paginates deeper than a keyword search; ideal when you want every listing in a category.
• Keep includeReviews off for bulk runs — it adds extra fetches per business. Pull a clean directory first, then enrich the top 50 by rating with reviews on a second run.
• Sort by Highest Rated for outreach lists — pulls reputation leaders first, useful when you want quality over coverage.
• Mix startUrls with searchTerms — combine a hand-picked list of profile URLs with broader keyword searches in the same run.
• Set a small maxResults first — start with 25–50 to confirm the data shape matches your needs, then scale to thousands.
• maxReviewsPerBusiness: 0 captures every review — up to an internal safety cap of ~2,000 per business. Use only when you need full review depth (e.g. sentiment analysis), not for routine lead lists.

Pricing

$0.80 per 1,000 results — pay only for what you get. No compute charges, no separate per-page fees.

Results	Cost
100	$0.08
1,000	$0.80
10,000	$8.00
100,000	$80.00

A "result" is one business row in the dataset, regardless of how many embedded reviews come with it. Platform fees (storage, dataset hosting) are additional and depend on your Apify plan.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — Workflow automation
• Google Sheets — Direct spreadsheet export
• Slack / Email — Notifications on new results
• Webhooks — Trigger custom APIs on run completion
• Apify API — Full programmatic access

Legal & Ethical Use

This actor is designed for legitimate business research, market analysis, lead generation, and directory enrichment. Users are responsible for complying with applicable laws and Yellow Pages' Terms of Service. Do not use the extracted data for spam, harassment, scraping for the purpose of mass unsolicited contact, or any illegal purpose. Respect the do-not-call registry, anti-spam regulations (CAN-SPAM, TCPA), and any opt-out signals when reaching out to businesses captured here.