The Yellow Pages Scraper avatar

The Yellow Pages Scraper

Pricing

from $0.01 / 1,000 results

Go to Apify Store
The Yellow Pages Scraper

The Yellow Pages Scraper

Scrape business listings from Yellow Pages. Extract comprehensive business data including phone numbers, addresses, websites, hours, reviews, and more for any category and location in the US. Category Search, Location Targeting, Comprehensive Data, Smart Filtering, Review Extraction & Export Ready

Pricing

from $0.01 / 1,000 results

Rating

0.0

(0)

Developer

The Howlers

The Howlers

Maintained by Community

Actor stats

0

Bookmarked

18

Total users

0

Monthly active users

11 days ago

Last modified

Features

Limited permissions

Share

Yellow Pages Scraper - Business Listings & Contact Data

Scrape business listings from Yellow Pages. Extract phone numbers, addresses, websites, hours, reviews, and more for any category and location.

Note: this actor runs in Demo Mode by default, so a default free run returns sample data. Set demoMode to false to fetch real data.


Quick Start

Test with Demo Mode (free, no API key needed)

{
"demoMode": true,
"searchQuery": "plumber",
"location": "Miami, FL",
"maxResults": 5,
"includeHours": false,
"includeCategories": false,
"proxyConfiguration": {
"useApifyProxy": false
}
}

Run with real data

{
"demoMode": false,
"searchQuery": "plumber",
"location": "Miami, FL",
"maxResults": 5,
"includeReviews": false,
"includeHours": false,
"includeCategories": false,
"minRating": 0,
"hasWebsite": false,
"hasPhone": false,
"proxyConfiguration": {
"useApifyProxy": false
}
}

Search by phone number

Set phone to look a business up by its phone number instead of its name. Yellow Pages' search takes a phone number as the search term, so this finds a listing even when Yellow Pages stores the name spelled differently or with broken characters (for example "EÅ?S Fitness" for "EōS Fitness"). Only listings that show this phone are returned and charged; other businesses Yellow Pages puts on the page are left out. Give the full 10-digit number with its area code; a shorter number stops the run with an error and nothing is searched.

Give searchQuery as well to run the name search and the phone search in the same run (one Actor start). A listing both searches find is one row and is charged once. Each row then has matchedBy: name, phone or both. maxResults applies to each search separately, so such a run can return and charge up to twice maxResults rows (phone-search rows must still show the phone exactly).

{
"demoMode": false,
"phone": "(602) 887-4836",
"location": "Phoenix, AZ",
"maxResults": 5,
"includeHours": false,
"includeCategories": false
}

What each row holds

  • rating is the Yellow Pages star rating shown on the listing (for example 4.5), and reviewCount is the number of Yellow Pages reviews next to it. Both are 0 when the listing has no Yellow Pages reviews.
  • yearsInBusiness comes from the "Years in Business" badge only. The "Years with Yellow Pages" badge is a different number and is not used.
  • address is the street, and city, state and zipCode are split out of the address Yellow Pages shows. This works for regular results and for paid and featured listings, which show the whole address on one line. fullAddress is the address exactly as the listing shows it.
  • Some businesses hide their address and show "Serving the Spring Hill Area" instead. Those rows have serviceArea (here "Spring Hill"), no street, and city, state and ZIP only when Yellow Pages files the listing under a city. Then localityFromListingLink is true.
  • website is the business's own site. A "Website" link that points back to Yellow Pages is not returned as a website.
  • With includeHours the hours come from the listing page, one entry per row of its hours table (for example "Mon - Fri": "8:00 am - 4:00 pm"). With includeReviews up to 5 reviews per listing are returned, each with author, star rating, text and date. Each review returned is one Review Scraped event.
  • A run never saves more listings or reviews than its maximum total charge allows. Rows found beyond it are left out and not charged, and the run's SUMMARY says how many.

Input Parameters

ParameterTypeDefaultRequiredDescription
searchQuerystring-NoBusiness category or keyword to search for (e.g., 'plumber', 'restaurant', 'dentist'). Not needed when you search by phone only.
locationstring-NoCity, state, or ZIP code to search (e.g., 'Miami, FL', '90210')
phonestring-NoSearch by this 10-digit phone number, e.g. '(602) 887-4836'. Only listings showing this phone are returned and charged from the phone search. With searchQuery as well, both searches run in one run and each row has matchedBy ('name', 'phone' or 'both'). location is still required.
maxResultsinteger100NoMaximum number of businesses to scrape (default: 100). With both searchQuery and phone it applies to each search separately, so a run can return and charge up to twice this number.
includeReviewsbooleanfalseNoExtract review snippets for each business (slower)
includeHoursbooleantrueNoExtract operating hours for each business
includeCategoriesbooleantrueNoExtract all business categories/services
minRatingnumber0NoOnly include businesses with at least this rating (1-5)
hasWebsitebooleanfalseNoOnly include businesses that have a website
hasPhonebooleanfalseNoOnly include businesses that have a phone number
proxyConfigurationobject{"useApifyProxy": false}NoProxy settings. Leave it off: yellowpages.com blocks Apify residential proxies, while direct requests work.
demoModebooleantrueNoRun with sample data instead of actual scraping (for testing). Set to false for real scraping.
webhookUrlstring-NoURL to POST results when scraping completes (Zapier, Make, n8n, custom endpoint)

Pricing

This actor uses pay-per-event billing:

EventWhen it is chargedPrice
Actor startOnce when the run starts, one event per GB of memory (minimum one). At the default 2 GB of memory a run starts at $0.20$0.10 per GB
Listing ScrapedPer business scraped$0.005
Review ScrapedPer review extracted$0.002
ResultEach item written to the default dataset$0.00001

Demo mode is free -- no charges for sample data.


Troubleshooting

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

  • Invalid input format (check the examples above)
  • The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.


Built by John Rippy | Actor Arsenal