YellowPages Scraper - US Business Leads

Disclaimer: This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Thryv, Inc. or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "YellowPages.com" is referenced only to describe the publicly available website this Actor collects data from.

Turn any trade + location into a clean list of US business leads from YellowPages.com. Search by category and city (or ZIP), or paste YellowPages search URLs directly, and get one structured row per business - name, phone, website, full address, categories, rating and more - ready for a CRM, a call list or outreach.

What you get per business

Group	Fields
Identity	name, ypId, listingId, yellowPagesUrl
Contact	phone (~100%), website (~99%)
Address	street, city, state, postalCode, fullAddress (~95-100%)
Classification	categories[], primaryCategory (~100%)
Reputation	rating, reviewCount, yearsInBusiness
Context	openStatus, snippet, isClaimed, isAd, listingType, rank, page

Input

{
  "searchTerms": ["plumbers", "electricians"],
  "location": "Chicago, IL",
  "maxItems": 200
}

• Search terms + location - a trade and a city ("Chicago, IL") or a ZIP code, or
• Search URLs - paste YellowPages.com search result URLs directly.
• Filters - exclude sponsored results (excludeAds), require a phone, require a website, or set a minimum star rating.

Reliability

YellowPages sits behind Cloudflare, so this is a full browser actor built to clear it: it opens a fresh browser context per attempt and waits for the challenge to pass rather than using a fixed timeout, with a generous retry budget. A run that genuinely cannot get through emits nothing, bills $0, and says so in the status message - you are never charged for a blocked run.

Honest limits (what the source does and does not carry)

• rating ~27% / reviewCount ~18%. Most YellowPages listings have never been reviewed - this is the source, not the parser (on a full page it reads the value from every card that carries one). Density depends on the trade: dentists ~60%, restaurants ~48%, plumbers ~21%.
• yearsInBusiness ~35%, openStatus ~56%, snippet ~54% are owner-supplied profile fields; unclaimed listings simply have none.
• Sponsored listings are kept, not hidden, and flagged with isAd. A sponsored service-area business often has no street address ("Serving the Chicago area") - that text is preserved rather than dropped. Set excludeAds: true for organic listings only.
• Search-page data only - no per-business detail-page crawl, so no opening-hours table and no review text.

Pricing

$0.002 per business, no start fee. Only rows you actually receive are billed; a blocked run costs nothing.

Output views

• Businesses - the full record.
• Call list - name, phone, street, city, state, ZIP, category, rating - ready to dial.

Use with AI assistants (MCP)

Available through the Apify MCP server - an agent can pull a fresh list of local businesses (with phone and website) for a trade and city on demand.

Agent-ready: autonomous payments (x402 & Skyfire)

This actor is agent-ready — AI agents can discover it, run it, and pay for it autonomously, with no Apify account and no human in the loop. It uses pay-per-event pricing and limited permissions, so it qualifies for Apify's agentic-payment standards:

• x402 — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the Apify MCP server — no account, no API key.
• Skyfire — agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

Automate & schedule

Run this Actor on autopilot and pull results into your own stack:

• Apify API - start runs, fetch datasets and manage schedules over REST.
• apify-client for JavaScript and apify-client for Python - official SDKs.
• Schedules - run it hourly, daily or weekly and keep your dataset current.
• Webhooks - trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/yellowpages-scraper').call({
    "searchTerms": [
        "plumber"
    ],
    "location": "Chicago, IL",
    "maxResults": 20,
    "maxPagesPerSearch": 1,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} records`);

Integrate with any app

Connect the dataset to thousands of apps - no code required:

• Make - multi-step automation scenarios.
• Zapier - push new records straight into your CRM or spreadsheet.
• Slack - get notified when a scheduled run finds something new.
• Google Drive / Sheets - auto-export every run to a spreadsheet.
• Airbyte - pipe results into your data warehouse.
• GitHub - trigger runs from commits or releases.

FAQ

How is this Actor billed? Pay-per-event: you pay only for the results it delivers, with no monthly rental and no start fee. The per-event price is shown on the Pricing tab.

Can I schedule it and get results automatically? Yes - create a Schedule and add a webhook or an integration (Google Sheets, Slack, Make, Zapier) to push each run's dataset wherever you need it.

Which export formats are available? Every run's dataset can be downloaded as JSON, CSV, Excel (XLSX), XML, HTML or RSS from the Apify Console or the API.

Can I run it from code or an AI agent? Yes - through the Apify API and client libraries, or from Claude, ChatGPT and other assistants via the Apify MCP server.

Is it legal to scrape YellowPages.com? This Actor collects publicly available data only. You are responsible for using the output in compliance with applicable laws (including data-protection law where personal data is involved) and the source's terms. See the Disclaimer below.

Is this an official YellowPages.com tool? No. It is an independent, third-party Actor with no affiliation to, endorsement by or sponsorship from Thryv, Inc. See the Disclaimer below.

Disclaimer

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Thryv, Inc. or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.

"YellowPages.com" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official YellowPages.com product, is not authorised or certified by Thryv, Inc., and does not distribute YellowPages.com software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

Need help?

Open an issue on the Actor's Issues tab, or visit the Apify help center. Feature requests are welcome - this Actor is actively maintained.