The Yellow Pages Scraper
Pricing
from $0.01 / 1,000 results
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
Maintained by CommunityActor stats
0
Bookmarked
18
Total users
0
Monthly active users
11 days ago
Last modified
Categories
Features
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
ratingis the Yellow Pages star rating shown on the listing (for example 4.5), andreviewCountis the number of Yellow Pages reviews next to it. Both are 0 when the listing has no Yellow Pages reviews.yearsInBusinesscomes from the "Years in Business" badge only. The "Years with Yellow Pages" badge is a different number and is not used.addressis the street, andcity,stateandzipCodeare 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.fullAddressis 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. ThenlocalityFromListingLinkis true. websiteis the business's own site. A "Website" link that points back to Yellow Pages is not returned as a website.- With
includeHoursthe hours come from the listing page, one entry per row of its hours table (for example "Mon - Fri": "8:00 am - 4:00 pm"). WithincludeReviewsup 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
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
searchQuery | string | - | No | Business category or keyword to search for (e.g., 'plumber', 'restaurant', 'dentist'). Not needed when you search by phone only. |
location | string | - | No | City, state, or ZIP code to search (e.g., 'Miami, FL', '90210') |
phone | string | - | No | Search 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. |
maxResults | integer | 100 | No | Maximum 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. |
includeReviews | boolean | false | No | Extract review snippets for each business (slower) |
includeHours | boolean | true | No | Extract operating hours for each business |
includeCategories | boolean | true | No | Extract all business categories/services |
minRating | number | 0 | No | Only include businesses with at least this rating (1-5) |
hasWebsite | boolean | false | No | Only include businesses that have a website |
hasPhone | boolean | false | No | Only include businesses that have a phone number |
proxyConfiguration | object | {"useApifyProxy": false} | No | Proxy settings. Leave it off: yellowpages.com blocks Apify residential proxies, while direct requests work. |
demoMode | boolean | true | No | Run with sample data instead of actual scraping (for testing). Set to false for real scraping. |
webhookUrl | string | - | No | URL to POST results when scraping completes (Zapier, Make, n8n, custom endpoint) |
Pricing
This actor uses pay-per-event billing:
| Event | When it is charged | Price |
|---|---|---|
| Actor start | Once 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 Scraped | Per business scraped | $0.005 |
| Review Scraped | Per review extracted | $0.002 |
| Result | Each 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
