Yellow Pages USA Business Scraper

Extracts public US business-directory listings from YellowPages.com using fingerprinted Chrome sessions. Search mode supports pagination; direct mode loads supplied public profiles. Available fields include name, phone, address, categories, ratings, reviews, hours, website/menu/email, images, open status, price range, years in business, badges, listing type, and social profiles.

Input

Search example:

{
  "mode": "search",
  "searchQuery": "pizza restaurants",
  "location": "New York, NY",
  "maxItems": 10,
  "maxPages": 5,
  "maxConcurrency": 2,
  "proxyConfiguration": { "useApifyProxy": true }
}

Direct-profile example:

{
  "mode": "businessUrl",
  "startUrls": [
    { "url": "https://www.yellowpages.com/mip/example-123456789" }
  ],
  "maxItems": 1
}

searchQuery and location are required in search mode. Direct mode requires HTTPS public YellowPages.com /mip/ URLs. maxItems accepts 1–1,000, maxPages accepts 1–50, and browser concurrency is bounded from 1–5. Proxy configuration is optional.

Output

Every row uses recordType: "yellow_pages_business" and contains a stable ID, sequential position, name, canonical profile/source URL, source domain, address, phone, scrape time, and explicit source/provenance/transport/extraction-method fields. Search rows also expose listingType, isServiceAreaResult, and locationMatch when the public card supplies enough address context; this makes YellowPages service-area and out-of-city placements explicit. The OUTPUT run summary records success, partial success, or failure plus counts and failed URLs without adding diagnostics to the dataset.

Example:

{
  "recordType": "yellow_pages_business",
  "id": "123456789",
  "position": 1,
  "name": "Example Plumbing",
  "url": "https://www.yellowpages.com/mip/example-plumbing-123456789",
  "address": "10 Main Street, New York, NY 10001",
  "phone": "212-123-4567",
  "categories": ["Plumbers"],
  "rating": 4.7,
  "reviewCount": 38,
  "scrapedAt": "2026-08-16T10:00:00.000Z"
}

Cost and limits

The actor uses Chrome, session rotation, at most two retries per request, bounded pages/items/concurrency, and an optional standard Apify proxy. No private access is attempted.

Tips

• Use direct mode when profile URLs are already known.
• Keep id and url for deduplication.
• Treat ratings, hours, and review content as observations at fetch time.

FAQ

Does it bypass CAPTCHAs? No. It detects visible challenges and fails/retries rather than interacting with protected pages.

Why are records missing? Rows without a real name, profile URL, address, or phone are discarded.

Where are results stored? Businesses are in the default dataset; the run summary is in OUTPUT.

Disclaimer

Use the data responsibly and follow YellowPages.com terms, robots guidance, and applicable laws. This actor is not affiliated with YellowPages.com.