Yellow Pages Scraper USA — Business Leads

Extract US business listings from yellowpages.com at scale. Get business name, phone, address, website, email, hours, services, categories, ratings, review counts, social links, BBB accreditation, claimed status, years in business, and optional customer reviews — all in clean, CRM-ready structured JSON.

Search by keyword + location, paste category URLs, or pull individual business profiles. Mix all three input modes in a single run. Optimized for B2B lead generation, local-SEO analysis, market research, and AI-agent pipelines.

What it does

• Search mode: provide searchTerms + locations (cross-joined) — e.g. ["plumber", "electrician"] × ["Boston, MA", "Austin, TX"] = 4 searches
• URL mode: paste yellowpages.com search URLs, city-category pages (/boston-ma/plumbers), or individual business profiles (/mip/<slug>-<id>)
• Multi-input: combine search terms and direct URLs in one run
• Pagination: crawls up to maxPagesPerSearch result pages per search
• Detail enrichment: visits each business profile page for the full field set (email, hours, services, socials, trust signals)
• Reviews: optional per-business customer reviews (newest-first, capped via maxReviewsPerBusiness)
• Sort: by relevance (default), distance, name, or rating

Use cases

• Build targeted B2B prospect lists by category and ZIP/city for outbound sales
• Pull every business in a category or metro for market coverage and competitor mapping
• Filter for unverified/owner-unclaimed listings to identify outreach opportunities
• Enrich existing CRM data with verified phone, website, structured address, hours, socials
• Extract customer reviews for sentiment analysis, quality benchmarking, reputation research
• Map local business density and compare market-level metrics (ratings, review volume, years in business)
• Seed RAG/LLM corpora with structured local-business records

Input

Field	Type	Required	Default	Description
searchTerms	string[]	no	["plumber"]	Keywords/categories — cross-joined with locations
locations	string[]	no	["Boston, MA"]	US locations in "City, ST" or ZIP format
startUrls	array	no	[]	Direct yellowpages.com URLs (search, category, or profile)
sortBy	enum	no	default	default/distance/name/rating
includeReviews	boolean	no	false	Embed customer reviews per business
maxReviewsPerBusiness	integer	no	30	Cap on reviews per business (0 = all, hard cap ~2000)
maxResults	integer	no	100	Hard cap on total business rows (0 = unlimited, internal cap 100k)
maxPagesPerSearch	integer	no	5	Max result pages per search/URL
proxyConfiguration	object	no	US residential	Required: US residential proxies (Cloudflare blocks datacenter)

Output

One record per business in the dataset:

Field	Type	Example
name	string	"Acme Plumbing"
phone	string|null	"(617) 555-1234"
email	string|null	"info@acme.com"
website	string|null	"https://acme.com"
address	object	{street, city, state, postalCode, country}
addressFormatted	string	"123 Main St, Boston, MA 02108"
coordinates	object|null	{lat, lng}
categories	string[]	["Plumbing","Contractor"]
primaryCategory	string|null	"Plumbing"
services	string[]	["Drain cleaning","Water heater repair"]
paymentMethods	string[]	["Visa","Mastercard"]
hours	object|null	{mon:"8:00-17:00",...}
rating	number|null	4.5
reviewCount	number|null	128
reviews	array|null	[{author,rating,date,text}] (when includeReviews=true)
socialLinks	object	{facebook,instagram,linkedin,twitter,youtube}
logo	string|null	url
photos	string[]	[url,...]
claimed	boolean	true
bbbAccredited	boolean	false
yearsInBusiness	number|null	12
description	string|null	"Family-owned plumbing services since..."
tagline	string|null	"Your trusted local plumber"
isAd	boolean	false
yellowPagesId	string	"123456789"
profileUrl	string	https://www.yellowpages.com/.../mip/acme-12345
sourceUrl	string	URL crawled
searchTerm	string	"plumber"
searchLocation	string	"Boston, MA"
scrapedAt	string	ISO 8601 timestamp

Pricing

This actor uses pay-per-event pricing — you only pay for results delivered.

Event	Price	When charged
Actor Start	$0.00005	Once per run (per 1 GB memory)
Business Listing	$0.001	Per business record extracted

Cost examples:

• 100 businesses = ~$0.10
• 1,000 businesses = ~$1.00
• 10,000 businesses = ~$10.00

Usage-based billing (compute + proxy passthrough) is also enabled for heavy users — see the Pricing tab for tier details.

Proxy requirements

US residential proxies are required. Yellow Pages is fronted by Cloudflare and blocks datacenter IPs and non-US residential ranges. The default proxy configuration uses Apify's RESIDENTIAL group with countryCode: US.

For aggressive anti-bot environments, you can supply a custom premium residential proxy (Decodo, Bright Data, IPRoyal) via the proxy configuration input.

Quick start

# Install Apify CLI
npm install -g apify-cli

# Clone and deploy
cd yellow-pages-us-scraper
npm install
apify login
apify push -f -w 120

API usage

# Run via API
curl -X POST "https://api.apify.com/v2/acts/USERNAME~yellow-pages-us-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["dentist"],"locations":["Austin, TX"],"maxResults":50}'

// Node.js / Apify SDK
import { Actor } from 'apify';

const run = await Actor.call('USERNAME/yellow-pages-us-scraper', {
    searchTerms: ['dentist'],
    locations: ['Austin, TX'],
    maxResults: 50,
    includeReviews: true,
    maxReviewsPerBusiness: 10,
});

const { items } = await Actor.dataset(run.defaultDatasetId).listItems();
console.log(items);

Tips

• Start small: set maxResults: 10 to verify data quality before scaling
• Reviews are slow: enabling includeReviews roughly doubles runtime and cost — use only when needed
• Large coverage: split a big request across multiple cities/ZIPs — a single search caps at ~6,000 results
• Sort by rating: set sortBy: "rating" to surface top-rated businesses first
• Cross-join math: 2 terms × 3 locations = 6 searches; results are merged and deduplicated by profile URL

Limitations

• Yellow Pages itself caps results at roughly 30 pages (~6,000 listings) per search term + location pair
• Reviews are capped at ~2,000 per business by Yellow Pages
• Email is only available when present on the business profile page (many YP listings do not show email)

Export & integrations

Export scraped data to JSON, CSV, or Excel from the Apify Console. Use webhooks or the Apify API to push results to HubSpot, Salesforce, Google Sheets, Airtable, or any HTTP endpoint. Schedule runs via the Apify Scheduler for ongoing monitoring.

---

Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.

What is Yellow Pages Scraper USA?

Yellow Pages Scraper USA turns the target data into structured, reusable results on Apify. Use it when you need repeatable collection for sales teams, agencies, recruiters, market researchers, and data-enrichment workflows without maintaining a custom scraper or one-off integration. Run it manually, schedule recurring jobs, call it through the Apify API, or connect it to an AI agent through the Apify MCP server.

The Actor stores results in an Apify dataset, where they can be previewed and exported as JSON, CSV, Excel, XML, or RSS. Availability and completeness depend on the source, supplied inputs, public visibility, authentication requirements, and upstream rate limits.

Use cases for Yellow Pages Scraper USA

• Build structured datasets for research, reporting, enrichment, or monitoring.
• Automate repetitive collection with schedules, webhooks, and API calls.
• Feed clean records into spreadsheets, databases, CRMs, BI tools, AI agents, or RAG pipelines.
• Track changes over time by running the same validated input on a schedule.
• Replace fragile manual copy-and-paste work with a reproducible Apify workflow.

How to use Yellow Pages Scraper USA

1. Open the Actor input page and choose a focused, valid target.
2. Set a conservative result limit for the first run.
3. Start the Actor and inspect the dataset for coverage and field availability.
4. Export the results or connect the dataset to your downstream system.
5. Scale gradually and use scheduling, pagination, or proxies when supported.

Important input options

• searchTerms — Keywords or business categories to search for on Yellow Pages. Examples: "plumber", "dentist", "italian restaurant", "auto repair". Each term is cross-joined with every entry in Locations —
• locations — US locations in "City, ST" format, or 5-digit ZIP codes. Examples: "Boston, MA", "90210", "Brooklyn, NY", "Austin, TX". Each location is cross-joined with every search term. Use "City, ST" f
• startUrls — Paste one or more yellowpages.com URLs. Accepts search results (yellowpages.com/search?...), city-category pages (yellowpages.com/boston-ma/plumbers), or individual business profiles (yellow
• sortBy — How Yellow Pages sorts the search results before we collect them. "default" = relevance (YP's own ranking). "distance" = nearest first. "name" = alphabetical. "rating" = highest rated first.
• includeReviews — When enabled, embed each business's customer reviews on the result row (newest first). Off by default — turning this on makes runs slower and more expensive, since each business needs additi
• maxReviewsPerBusiness — Cap on the number of reviews captured per business when "Include Client Reviews" is on (most recent first). Set to 0 to capture every available review (an internal hard cap of ~2,000 reviews
• maxResults — Hard cap on total business rows across all searches and URLs. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 100,000 still applies). The actor sto
• maxPagesPerSearch — Maximum result pages to crawl per (search term x location) pair or per start URL. Yellow Pages typically caps results around 30 pages. Lower this for faster, cheaper runs; raise it for exhau

API and automation example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/yellow-pages-us-scraper').call({
  // Add the same input fields you use in the Apify Console.
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Related Apify Actors

Use these dedicated tools when a neighboring data source or workflow is a better match:

• Leads Finder Pro - B2B Leads with Emails [Apollo Alternative]
• Yellow Pages Australia Scraper — Business Leads & Reviews
• California CSLB Contractor License Scraper
• Instagram Followers & Following Scraper — With Cookies
• OpenTable Restaurants, Ratings & Reviews Scraper
• Etsy Scraper Pro — Products, Prices, Reviews & Shop Data
• YouTube Thumbnail Downloader
• AllTrails Scraper — Hiking Trails, Reviews & GPS Data
• Email Validator — Syntax, MX & Risk Checks
• Google Play Reviews Scraper

Frequently asked questions

How many results can I scrape with Yellow Pages Scraper USA?

The practical total depends on the source, input limits, pagination, available records, run timeout, and upstream restrictions. Start with a small run, verify the output, and increase the limit gradually.

Can I integrate Yellow Pages Scraper USA with other apps?

Yes. Use Apify integrations, webhooks, schedules, dataset exports, Make, Zapier, Google Sheets, cloud storage, or your own application.

Can I use Yellow Pages Scraper USA with the Apify API?

Yes. Start runs with the Apify REST API or an official Apify client, then retrieve records from the run's default dataset. Keep your API token in a secret or environment variable.

Can I use Yellow Pages Scraper USA through an MCP Server?

Yes. The Apify MCP server can expose the Actor to compatible AI clients and agents. Review the input and expected cost before allowing an autonomous workflow to run it at scale.

Do I need proxies?

It depends on the source and volume. Use the default configuration first. For larger or geographically sensitive jobs, select an appropriate proxy configuration only when the Actor supports it.

Is it legal to scrape this data?

Scraping rules vary by source, jurisdiction, data type, and intended use. Collect only data you are authorized to access, respect applicable terms and privacy laws, and avoid restricted or personal data misuse. This documentation is not legal advice.

Your feedback

If a field is missing, a source layout has changed, or you need a supported use case documented, open an issue on the Actor page with a reproducible input and run ID.