Yellow Pages Business Directory Scraper

What this Actor scrapes

yellowpages.com carries US business listings spanning name, phone, address, categories, ratings, and websites for local-service and retail businesses across every US city. This Actor searches its public results pages by keyword and city, writing one structured row per listing — no login, no scraping the individual business detail pages, just the search-results feed, paginated to your maxResults cap.

Give it a searchTerm (category or free-text keyword) and a location ("City, ST") and it pages through results until it hits your maxResults cap, the site's own listing total, or the last page — whichever comes first.

What we handle for you

• 🛡️ We rotate browser fingerprints (curl-cffi impersonation — Chrome / Firefox / Safari) so the target sees real-browser traffic, not Python.
• 🔁 We retry with exponential backoff on 408 / 429 / 5xx and honour Retry-After — up to 5 attempts per page.
• 🌐 We rotate proxy sessions on every block — fresh session, fresh exit IP, before the next attempt.
• 🧱 We back off when the target rate-limits. Partial successes surface clearly; we never silently return an empty dataset.
• 🧊 We keep the dataset clean — Pydantic-validated rows, ISO-8601 timestamps, stable field shapes.
• 💰 You pay only for results that land. No data → no charge (only the small actor-start warm-up fee).

Use cases

• Lead-gen list building — pull every plumber, roofer, or dentist in a target city into a call/email list ready for outreach.
• Local-market research — compare business density and category mix across cities before opening a new location or launching an ad campaign.
• Sales prospecting tools — ingest directory data as a feed for a broader prospecting or CRM-enrichment pipeline.
• Competitive scans — see how many competitors of a given category operate in a city, and how they compare on ratings and review counts.

Input

Paste this into the Apify Console, or send it as the run input over the API. Proxy settings are on by default; you rarely need to touch them.

{
  "searchTerm": "plumbers",
  "location": "Austin, TX",
  "maxResults": 300,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

Output

One row per result, schema-validated before it is written. Export JSON, CSV, Excel or XML from the run, or read it over the API.

business_namephonestreet_addresscitystatezip_codecategorieswebsiteratingreview_countlisting_urlsearch_termlocation_queryscraped_at

{
  "business_name": "ARS / Rescue Rooter",
  "phone": "(512) 837-9500",
  "street_address": "1500 W Anderson Ln",
  "city": "Austin",
  "state": "TX",
  "zip_code": "78757",
  "categories": [
    "Plumbers",
    "Air Conditioning Contractors & Systems",
    "Heating Contractors & Specialties"
  ],
  "website": "https://www.ars.com/austin",
  "rating": 4.5,
  "review_count": 128,
  "listing_url": "https://www.yellowpages.com/austin-tx/mip/ars-rescue-rooter-473194899",
  "search_term": "plumbers",
  "location_query": "Austin, TX",
  "scraped_at": "2026-07-30T12:00:00Z"
}

Pricing

You pay only for results that land. Cap any run with maxTotalChargeUsd. See pricing & billing for worked examples.