YellowPages Scraper - Phone, Website & Address Leads (US)

Here is one real result, with every field the actor returns:

{
  "name": "The Artful Dentist",
  "phone": "(512) 288-6444",
  "website": "http://theartfuldentist.localsearch.com",
  "address": "7500 W Highway 71 Ste 108, Austin, TX 78735",
  "street": "7500 W Highway 71 Ste 108",
  "city": "Austin, TX 78735",
  "categories": [
    "Dentists",
    "Teeth Whitening Products & Services",
    "Implant Dentistry"
  ],
  "rating": 4.5,
  "yearsInBusiness": null,
  "url": "https://www.yellowpages.com/austin-tx/mip/the-artful-dentist-9179414",
  "source": "YellowPages",
  "observedAt": "2026-08-15T13:51:32.593Z"
}

The most complete YellowPages lead scraper available. It returns every business the YellowPages directory lists for your keyword and location, with phone, website, full address, categories and rating, plus an optional paid add-on that finds a public contact email and a contact person's name for each result. Target any business type in any US city or ZIP.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches the YellowPages business directory for the keyword and location you pass as input, paginates through every matching listing, and writes one normalized record per business to the run's dataset. Each record carries the business name, phone, website, full address (with street and city split out), categories, rating and profile URL. Text is HTML-decoded and whitespace-normalized, missing source values are returned as null, and results are deduplicated by profile URL.

An optional paid contact enrichment add-on can attempt, for each business without an email, to find a public business contact email and a contact person's name. It is off by default and billed separately (see Billing and limits).

Data covers US businesses listed on YellowPages. It does not include businesses that are not listed in the directory.

Quickstart

Open the actor, paste this into the input, and press Run. It returns up to 10 dentist listings in Austin, TX.

{
  "searchQuery": "dentist",
  "location": "Austin, TX",
  "maxBusinesses": 10
}

Change searchQuery to any business type and location to any US city, state or ZIP. Every input field is optional; with an empty input the actor searches plumber in Austin, TX.

Input reference

Field	Type	Required	Default	Description
searchQuery	string	no	plumber	The type of business to find, for example dentist, restaurants, auto repair.
location	string	no	Austin, TX	City and state or ZIP code, for example Austin, TX, New York, NY, 90210.
maxBusinesses	integer	no	10	Maximum number of businesses to collect. Range 1 to 3000.
enrichContacts	boolean	no	false	Optional paid add-on. For each result without an email, attempt to find a public business contact email and a contact person's name. Billed per attempt, plus an extra charge only when an email is found.
enrichContactsMax	integer	no	50	Cap how many results the add-on tries to enrich, to control add-on cost. Free Apify accounts are capped at 3.

Output reference

One dataset item per business. Types: string, number, string[], or null when the source value is absent.

Field	Type	Description
name	string	Business name as listed on YellowPages.
phone	string	Business phone number, or null.
website	string	Business website URL, or null when the listing has none.
address	string	Full street address including city, state and ZIP.
street	string	Street portion of the address.
city	string	Locality portion of the address (city, state and ZIP as listed).
categories	string[]	Business categories from the listing, or null.
rating	number	Star rating from 1 to 5 (in half steps), or null when unrated.
yearsInBusiness	number	Years in business as stated on the listing, or null.
url	string	YellowPages profile URL for the business (used to deduplicate).
source	string	Source of the record. Always YellowPages.
observedAt	string	ISO 8601 timestamp of when the record was collected.
enrichedEmail	string	Public business contact email found by the add-on, or null. Present only when the enrichment add-on runs.
enrichedContactName	string	Contact person's name found by the add-on, or null.
enrichedJobTitle	string	Contact person's job title found by the add-on, or null.
enrichedEmailStatus	string	Add-on email status: verified, likely, guessed or not_found.
enrichedSource	string	URL the add-on found the contact on, or null.
enrichedConfidence	string	Add-on confidence: high, medium or low.

The enriched* fields are added only when the paid contact enrichment add-on is enabled on the run. Without the add-on, records contain the directory fields only.

Example output record

Real record from a live run (input {"searchQuery": "dentist", "location": "Austin, TX", "maxBusinesses": 8}):

{
  "name": "The Artful Dentist",
  "phone": "(512) 288-6444",
  "website": "http://theartfuldentist.localsearch.com",
  "address": "7500 W Highway 71 Ste 108, Austin, TX 78735",
  "street": "7500 W Highway 71 Ste 108",
  "city": "Austin, TX 78735",
  "categories": [
    "Dentists",
    "Teeth Whitening Products & Services",
    "Implant Dentistry"
  ],
  "rating": 4.5,
  "yearsInBusiness": null,
  "url": "https://www.yellowpages.com/austin-tx/mip/the-artful-dentist-9179414",
  "source": "YellowPages",
  "observedAt": "2026-08-15T13:51:32.593Z"
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~yellowpages-business-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery":"dentist","location":"Austin, TX","maxBusinesses":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~yellowpages-business-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery":"roofing contractor","location":"Dallas, TX","maxBusinesses":300}'

Apify CLI:

apify call scrapers_lat/yellowpages-business-scraper \
  --input '{"searchQuery":"plumber","location":"90210"}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per business returned (result event). See the pricing tab for the current per-result price.
• Contact enrichment add-on. When enrichContacts is on, each enrichment attempt is billed (contact-search-attempt), plus an extra charge only when an email is found (contact-email-found). The add-on is off by default.
• No charge on failure. If the first request fails, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 records per run, and at 3 enrichment attempts per run. Upgrade for higher maxBusinesses.

FAQ and troubleshooting

A run returned 0 records. Why? The keyword and location combination matched nothing in the directory. Try a broader keyword or a larger location (a state instead of a single city). Zero-result runs are not charged.

Why is website or rating null? Not every YellowPages listing publishes a website or has ratings. Missing source values are returned as null, never invented.

How do I get more than 10 results? Raise maxBusinesses (up to 3000) on a paid Apify plan. Free plans are capped at 10 records per run.

How does the contact enrichment add-on bill? It bills per attempt for each result without an email, and adds a separate charge only when a public email is actually found. Turn it off by leaving enrichContacts at false.

Can I search by ZIP code? Yes. Put a ZIP in location, for example 90210, or a city and state such as Austin, TX.

Is this an official YellowPages tool? No. This actor is independent and has no affiliation with YellowPages. It reads only data that is publicly listed on the directory.

Example tasks

Preconfigured templates for common scenarios. Open one and press Run, or use it as a starting point:

• Plumber leads in Austin, TX from Yellow Pages: Get plumber business leads in Austin, TX with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Electrician leads in Denver, CO from Yellow Pages: Get electrician business leads in Denver, CO with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Dentist leads in Miami, FL from Yellow Pages: Get dentist business leads in Miami, FL with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Roofing Contractor leads in Dallas, TX from Yellow Pages: Get roofing contractor business leads in Dallas, TX with names, phone numbers, addresses, and websites from Yellow Pages listings.
• HVAC leads in Phoenix, AZ from Yellow Pages: Get hvac business leads in Phoenix, AZ with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Landscaping leads in Seattle, WA from Yellow Pages: Get landscaping business leads in Seattle, WA with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Auto Repair leads in Chicago, IL from Yellow Pages: Get auto repair business leads in Chicago, IL with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Restaurant leads in Los Angeles, CA from Yellow Pages: Get restaurant business leads in Los Angeles, CA with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Real Estate Agent leads in Houston, TX from Yellow Pages: Get real estate agent business leads in Houston, TX with names, phone numbers, addresses, and websites from Yellow Pages listings.
• Lawyer leads in Atlanta, GA from Yellow Pages: Get lawyer business leads in Atlanta, GA with names, phone numbers, addresses, and websites from Yellow Pages listings.

Related scrapers

• Business Leads Scraper: Local business leads from OpenStreetMap by area and category.
• Hotfrog Business Scraper: Business listings with contacts from the Hotfrog directory.
• Google Maps Scraper: Places, contacts and reviews from Google Maps.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.