Yellow Pages US Business Scraper

US business listings from YellowPages.com by city and category — for example every plumber in Austin, TX or every dentist in San Diego, CA. For each business: name, phone, street address, city and ZIP, website, categories, years in business, Yellow Pages rating and review count, TripAdvisor rating and review count, open-now status, a description snippet, and whether it is a paid listing.

Reads Yellow Pages' public city/category pages. No login, no browser.

What it is for

• Local lead generation — phone, address and website for every business of a type in a city.
• Market mapping — how many businesses of a kind, how long they've operated, how they're rated.
• Advertiser research — which businesses pay for placement, and how high.

Input

field	what it does
locations	"Austin, TX", "New York, NY", …
categories	plumbers, restaurants, dentists, auto repair service, …
sortBy	best_match (Yellow Pages' default), name, rating.
maxItems	Businesses per city × category (default 60; 30 per page).

Four things worth knowing before you trust the data

1. A city Yellow Pages doesn't know is silently replaced

Asking for plumbers in a misspelled city returned "Best 18 Plumbers in Winters, TX" — a different real town, no error. This Actor checks that the page is about the city you asked for; if not, it returns no rows for that search and tells you which city Yellow Pages answered for.

2. "Best match" is largely a paid ranking

For plumbers in Austin, 17 of the first 30 results are paying subscribers, listed above the free listings — separately from the sponsored ads box, which this Actor leaves out entirely. Every row has isPaidListing, and each search's summary counts them. (In some categories — New York restaurants — all 30 were free.) Use sortBy: name or rating for a non-paid order.

3. The total changes while you page

Page 1 said "of 491"; page 17 said "of 511". The Actor keeps going until a page has no results rather than trusting the first total, and reports both.

4. Ratings are stored as words

Yellow Pages encodes its stars as CSS words ("four half"); TripAdvisor's rating travels separately. Both are converted to numbers (ypRating: 4.5, tripAdvisorRating: 4.5) with their review counts.

Output

{
  "recordType": "BUSINESS",
  "name": "Paul & Jimmy's Restaurant",
  "phone": "(212) 475-9540",
  "streetAddress": "123 E 18th St",
  "locality": "New York, NY 10003",
  "website": "https://www.paulandjimmys.com",
  "categories": ["Restaurants", "Italian Restaurants", "Bars"],
  "yearsInBusiness": 76,
  "ypRating": 4,
  "ypReviewCount": 1,
  "tripAdvisorRating": 4.5,
  "tripAdvisorReviewCount": 77,
  "isPaidListing": false
}

Limits

• Yellow Pages' search box results are not used — its robots.txt disallows them. City × category pages are the permitted route and cover the same businesses.
• Business detail pages are not fetched; the category page already carries the fields above.