Yellow Pages Scraper: Extract Local Business Listings from yellowpages.com

Yellow Pages scraper that pulls business listings from yellowpages.com. Give it a search term and a city, and it returns names, phones, addresses, websites, star ratings, and categories in a clean dataset.

Works for any business type: plumbers, dentists, restaurants, lawyers, electricians, contractors. It pages through results automatically and can pull up to 1000 listings per run.

Use cases

• Sales prospecting: build lead lists of local businesses by industry and city
• Competitor research: count and profile businesses in an area before opening a new location
• Directory building: populate a business database for a specific region and category
• Marketing outreach: collect phone numbers and websites for outreach campaigns
• Data enrichment: add phone, address, and rating data to existing business records

What data does this actor extract?

Each listing returns:

{
    "businessName": "Ritz Plumbing Heating, Air & Electrical",
    "phoneNumber": "(323) 452-4915",
    "streetAddress": "1355 S La Brea Ave",
    "city": "Los Angeles",
    "stateAbbr": "CA",
    "zipCode": "90019",
    "fullAddress": "1355 S La Brea Ave, Los Angeles, CA 90019",
    "website": "http://www.ritzplumbinginc.org/",
    "categories": ["Plumbers", "Heating Contractors & Specialties", "Air Conditioning Contractors & Systems"],
    "rating": 5.0,
    "reviewCount": 2,
    "yearsInBusiness": 95,
    "listingUrl": "https://www.yellowpages.com/los-angeles-ca/mip/ritz-plumbing-heating-air-electrical-9270807",
    "searchTerms": "plumber",
    "searchLocation": "Los Angeles, CA",
    "scrapedAt": "2025-01-15T09:32:11.452Z",
    "error": null
}

Input

Parameter	Type	Default	Description
searchTerms	string	required	Type of business to search (e.g. plumber, dentist, pizza restaurant)
location	string	required	City and state (e.g. Los Angeles, CA or Chicago, IL)
maxPages	integer	1	Number of result pages to scrape. Each page has up to 30 listings.
maxItems	integer	100	Maximum number of listings to return per run (up to 1000).
requestTimeoutSecs	integer	30	Per-request timeout in seconds.

Example input

{
    "searchTerms": "plumber",
    "location": "Los Angeles, CA",
    "maxPages": 3,
    "maxItems": 90
}

Output

The actor stores results in an Apify dataset. Each row is one business listing with the fields shown above.

Field	Type	Description
businessName	string	Business name as listed on Yellow Pages
phoneNumber	string	Primary phone number
streetAddress	string	Street address
city	string	City
stateAbbr	string	Two-letter state code
zipCode	string	ZIP code
fullAddress	string	Complete address string
website	string	Business website URL
categories	array	Business categories
rating	number	Star rating out of 5.0
reviewCount	integer	Number of reviews
yearsInBusiness	integer	Years in business (when listed)
listingUrl	string	Direct link to the YP listing
searchTerms	string	Search term from input
searchLocation	string	Location from input
scrapedAt	string	ISO 8601 scrape timestamp
error	string	Error message if parsing failed

FAQ

What search terms can I use? Any business category: plumber, dentist, lawyer, pizza, auto repair, electrician, HVAC, and so on. Use the same terms you would type into the Yellow Pages search box.

How many results are on each page? Yellow Pages shows up to 30 listings per page. Set maxPages to 3 to get up to 90 listings, or increase maxItems to cap the total.

Will this work for any US city? Yes. Enter the city and state in the location field (e.g. Chicago, IL or Miami, FL). Yellow Pages covers all US cities and many Canadian locations.

What if a field is missing for some listings? Not every listing has a website, rating, or years-in-business entry. Missing fields return null. The error field is only set if the listing failed to parse.

Can I run multiple searches at once? Run the actor multiple times with different search terms and locations. Use the Apify scheduler to run on a recurring basis.