Yellow Pages Scraper

US business listings with addresses, phones, websites, ratings, and opening hours.

Search Yellow Pages by term and location — "plumbers in Austin, TX", "chinese restaurants in San Francisco, CA" — and get every listing back as structured JSON, CSV, or Excel. Each result carries the business name, full postal address, phone number, rating, review count, and opening hours. Point it at individual business pages instead and you also get categories and the business website. Built for local lead generation, market mapping, and competitor research.

⚡ Quick start

{
  "searchTerms": ["chinese restaurants"],
  "location": "San Francisco, CA",
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

🧩 Input

Field	Type	Required	Default	Description
searchTerms	array	no¹	—	What to search for, e.g. plumbers. One entry per search.
location	string	no	—	City and state, e.g. San Francisco, CA. Applies to every search term.
startUrls	array	no¹	—	Yellow Pages URLs. Search pages and business pages are both supported.
maxItems	integer	no	30	Maximum businesses per search term or start URL. Search pages hold 30 listings each.
proxyConfiguration	object	no	{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US" }	Proxy settings. See the FAQ before changing this.

¹ Provide either searchTerms or startUrls.

📤 Output

One dataset row per business, in the same shape whether the row came from a search page or from a business page. Search listings are the cheaper source and carry everything except website and categories; business pages add those two. source tells you which produced the row.

Fields

Field	Type	Description
name	string	Business name.
url	string	Yellow Pages listing URL.
phone	string	Phone number as listed.
website	string	The business's own website. Business pages only.
address	string	Full address on one line.
street	string	Street portion of the address.
city	string	City.
state	string	Two-letter state code.
postalCode	string	ZIP code.
country	string	Two-letter country code.
categories	array	Business categories. Business pages only.
rating	number	Star rating out of 5, e.g. 4.5.
reviewCount	number	Number of reviews.
openingHours	object	Opening hours per weekday, e.g. { "Mo": "11:00-21:30" }.
source	string	search or business — which page type produced the row.
page	number	Results page the listing came from. null for business pages.

💡 Use cases

• Local lead generation — build prospect lists of businesses in a trade and city, with phone numbers and websites.
• Market mapping — count and compare businesses in a category across neighbourhoods or metros.
• Competitor research — track ratings, review counts, and opening hours for a set of local rivals.
• Data enrichment — fill in addresses and phone numbers for an existing list of business names.

❓ FAQ

• Do I need a proxy? Yes, US residential. Yellow Pages rejects datacenter IPs and limits how often a single IP can request pages, so the Actor stops with a clear error if you turn proxies off.
• How many results can I get? Each search page holds 30 listings and a popular search runs to hundreds of pages. Raise maxItems to go deeper; the Actor paginates automatically.
• Can I scrape a specific business? Yes — put its Yellow Pages URL in startUrls. Business pages return categories and the company website too.
• Why did some listings come back without a rating? Not every business has reviews. Unrated listings simply omit aggregateRating.
• Can I search outside the US? No. Yellow Pages covers US businesses only.

🔗 More scrapers by Anyx

• Bing Search Scraper
• Google Maps Email Extractor
• Indeed Scraper
• Kleinanzeigen Scraper

🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

• Email: tantosthor@gmail.com

Notice

Anyx Solutions is not affiliated with yellowpages.com, and this Actor is not supported or endorsed by it.