Yellow Pages Scraper - US Business Listings & Leads

Turn any YellowPages.com search into a clean, structured lead list. Give it a category and a US city, and this actor returns every matching business with its name, phone, full address, categories, website and years in business — ready to drop into a CRM, a spreadsheet, or an outbound campaign.

No login, no API key, no manual copy-paste. The actor searches YellowPages, walks every result page, de-duplicates listings, and hands you back tidy JSON / CSV / Excel.

Works in Claude, ChatGPT and any MCP-compatible AI agent — call it as a tool to pull local-business leads on demand ("get me 50 plumbers in Austin, TX").

---

What you can do with it

• Build local lead lists for sales outreach (plumbers, dentists, contractors, restaurants, salons…).
• Power lead-gen and agency workflows: pull fresh prospects by city and vertical.
• Enrich a territory map: who offers what service, where, and how to reach them.
• Feed an AI agent that needs real local-business data on the fly.

---

Input

Field	Type	Required	Default	Description
searchTerm	string	yes	plumbers	Business type / keyword to search (e.g. dentists, coffee shops, law firms).
location	string	yes	Austin, TX	US location as City, ST (e.g. Chicago, IL) or a 5-digit ZIP code.
maxResults	integer	no	100	Max unique businesses to return (1–1000). Pagination continues until reached.
proxyConfiguration	object	no	RESIDENTIAL / US	Apify Proxy config. US residential proxy is required — YellowPages blocks datacenter IPs.

Example input

{
  "searchTerm": "plumbers",
  "location": "Austin, TX",
  "maxResults": 50,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }
}

---

Output

One dataset item per business. The final item is a summary record with run totals.

Sample record

{
  "name": "Radiant Plumbing & Air Conditioning",
  "phone": "+1-512-263-9988",
  "street": "10612 Metric Blvd",
  "city": "Austin",
  "state": "TX",
  "zip": "78758",
  "categories": ["Plumbers", "Plumbing-Drain & Sewer Cleaning", "Air Conditioning Service & Repair"],
  "website": "https://www.radiantplumbing.com",
  "years_in_business": 25,
  "url": "https://www.yellowpages.com/austin-tx/mip/radiant-plumbing-air-conditioning-12345678",
  "search_term": "plumbers",
  "scraped_at": "2026-06-16T12:00:00.000Z"
}

Fields

Field	Description
name	Business name
phone	Primary phone, normalised to +1-XXX-XXX-XXXX when possible
street	Street address
city / state / zip	Parsed city, 2-letter state, ZIP
categories	Array of YellowPages category labels
website	Business website URL (if listed)
years_in_business	Number of years in business (if shown)
url	YellowPages detail-page URL
search_term	The term you searched
scraped_at	ISO-8601 timestamp of when the record was scraped

Some fields may be null when a listing doesn't publish them (e.g. no website, no years badge).

---

Pricing

Pay-per-result. You are charged $0.002 per business delivered (event business-scraped).

• The first 25 results are FREE on your Apify account (lifetime), so you can fully try the actor before paying a cent.
• Empty searches and failed/blocked runs are never charged — you only pay for real businesses pushed to the dataset.
• The summary record is free.

Apify platform usage (compute + residential proxy) is billed separately by Apify at their standard rates.

---

Tips for best results

• Use broad, common categories (plumbers, dentists, electricians) for the densest result lists.
• Use major cities for high volume; small towns naturally have fewer listings.
• Format location as City, ST (e.g. Austin, TX). ZIP codes also work.
• Keep RESIDENTIAL / US proxy enabled — it is required to avoid blocking.

---

FAQ

Do I need a YellowPages login or API key? No. The actor reads public search-result pages.

Why is a residential US proxy required? YellowPages serves a block page (HTTP 403) to datacenter IPs. US residential proxies look like ordinary US visitors, so requests succeed. The prefilled proxy config handles this for you.

Does it paginate, or just the first page? It paginates. The actor walks &page=2, &page=3, … de-duplicating across pages until it reaches maxResults or runs out of listings.

How are duplicates handled? Each listing is de-duplicated by a stable id (YellowPages listing id / detail URL, falling back to name + phone), so you won't get the same business twice across pages.

Why are some fields empty? Not every business publishes a website, ZIP or "years in business" badge. The actor returns what the listing shows and leaves the rest null.

Can I use this from an AI assistant? Yes. It's exposed as an MCP server, so Claude, ChatGPT and other MCP-compatible agents can call it directly as a tool.

Is scraping YellowPages legal? The actor only collects publicly available business information. You are responsible for using the data in compliance with YellowPages' terms and applicable laws (e.g. respecting do-not-call rules for any outreach).