Superpages Real-Time Data

Live US local-business leads from the Superpages directory — streamed to your dataset as they are collected.

Superpages Real-Time Data turns one of America's long-standing local business directories into an outreach-ready lead source. Point it at one or more services and cities — plumber in New York, NY, med spa in Austin, TX, roofing contractor in Chicago, IL — and every discovered business streams straight to your dataset with its name, phone, website, address, categories, ratings, and years in business. Turn on the enrichment options and the same row gains full business details (opening hours, extra phone numbers, coordinates, full categories) and public contact channels from the business's own website (email addresses and social handles). One business is always one row — enrichment never creates duplicates and never drops a partial record.

Free-tier notice: on a free Apify plan this Actor is capped at 2 results per run so you can evaluate the quality risk-free. Upgrade to a paid Apify plan for uncapped exports.

---

Who it's for

Local SEO agencies, lead-gen and outreach teams, CRM operators, market researchers, franchise developers, and sales teams building US SMB prospect lists.

What you can build with it

• SMB lead lists for cold outreach — pull every plumber, dentist, or contractor in dozens of metros in one run, with phone and website attached.
• Local SEO and competitor mapping — see which categories a market is saturated with, who has ratings momentum, and who has been in business longest.
• CRM and dialer enrichment — add emails and social profiles to existing business lists so sequences and dialers run on complete contact data.
• Market and franchise research — count and profile businesses by category, city, and years in business before entering a market.
• Review and reputation monitoring — collect public ratings and review history per business to see who is winning locally.
• Directory hygiene audits — spot businesses without a website, with stale phone numbers, or in inconsistent categories, then sell the fix.

Feature matrix

Feature (checkbox)	What it does	Default
Business Search	Keyword + city search across US local businesses. One row per business with name, phone, website, address, categories, rating, years in business, open status, and description.	On
Enrich with full business details	Keeps each search result as ONE row (detailsFetched: true) and adds hours, extra phones, coordinates, open status, and full categories. Adds a little extra time per record.	Off
Add lead details (emails & socials)	Keeps each business as ONE row (leadEnriched: true) and adds public email addresses and social profiles found on the business's own website. Adds a little extra time per record.	Off
Business Details	Full profiles for specific businesses you list by URL.	Off
Reviews & Ratings	Public reviews and star ratings for the businesses you list — reviewer, rating, date, review text.	Off
Scrape By URL	Paste any Superpages business, search, or city/category URL; the page type is auto-detected and structured business data is returned.	Off
Webhook	Optional real-time push of every record to Slack, Discord, Zapier, Make, n8n, or your CRM — in addition to the dataset.	Off

Every enabled feature is validated before the run starts: if a required list is empty, the Actor tells you exactly which field to fill instead of failing mid-run.

Input reference

Field	Type	Default	Notes
enableBusinessSearch	boolean	true	Primary feature. Prefilled demo: plumber + roofing contractor in New York, NY.
searchTerms	string[]	["plumber", "roofing contractor"]	What to look for: "plumber", "dentist", "auto repair", "med spa", "hvac contractor".
searchLocations	string[]	["New York, NY"]	US cities or areas: "Austin, TX", "Chicago, IL", "Phoenix, AZ". Each term is combined with every location.
searchMaxResults	integer	10	Businesses collected per term + location pair. 1–200.
searchIncludeSponsored	boolean	false	Include sponsored placements, flagged sponsored: true.
searchFetchFullDetails	boolean	false	Merge full business details into the same search row.
enrichLeadDetails	boolean	false	Merge website emails and social profiles into the same row.
leadDetailsSiteLookups	integer	3	Extra pages checked per business website when the homepage has no email. 1–6.
enableBusinessDetails	boolean	false	Full profiles for the exact businesses you list.
businessUrls	string[]	[]	e.g. https://www.superpages.com/new-york-ny/bpp/fred-smith-plumbing-heating-460765127
enableReviews	boolean	false	Public reviews and ratings.
reviewBusinessUrls	string[]	prefilled example	Business page URLs to collect reviews for.
maxReviewsPerBusiness	integer	10	Reviews per business. 1–100.
enableScrapeByUrl	boolean	false	Process any Superpages URL you paste.
scrapeUrls	string[]	prefilled example	Business, search, or city/category URLs.
webhookUrl	string	""	Optional real-time delivery URL.
webhookFormat	json | slack	json	slack produces a message payload.
proxyConfiguration	object	Residential, US	Residential connections are recommended for the most reliable results.

Example: 200 plumber leads in three metros

{
    "enableBusinessSearch": true,
    "searchTerms": ["plumber"],
    "searchLocations": ["New York, NY", "Chicago, IL", "Phoenix, AZ"],
    "searchMaxResults": 200,
    "searchFetchFullDetails": true,
    "enrichLeadDetails": true
}

Example: enrich an existing list with emails

{
    "enableBusinessSearch": false,
    "enableBusinessDetails": true,
    "businessUrls": [
        "https://www.superpages.com/new-york-ny/bpp/fred-smith-plumbing-heating-460765127",
        "https://www.superpages.com/new-york-ny/bpp/handyman-at-your-service-465119325"
    ],
    "enrichLeadDetails": true,
    "leadDetailsSiteLookups": 4
}

Output fields

One row per business (plus one row per review when Reviews & Ratings is on). Filter by featureType:

Field	Description
featureType	business_search, business_details, business_reviews, or scrape_by_url.
url	The business page URL on Superpages.
business_id, business_name	Directory ID and business name.
categories, primary_category	All directory categories, plus the first one.
phone, extra_phones	Main phone plus additional published numbers (canonical format, de-duplicated).
website, website_domain	The business's own site and its domain.
emails, email	Public email addresses from the business's own site (filled by Add lead details).
street_address, city, state, postal_code, country, address_full	Full mailing address.
latitude, longitude	Coordinates (filled by Enrich with full business details).
rating, review_count	Public star rating and number of ratings, when the business has them.
years_in_business	Listing age signal.
claimed	Whether the business has claimed its listing.
open_status, hours	Current status and published opening hours.
payments	Accepted payment options.
description	Business description.
social_links, social_urls	Facebook / Instagram / LinkedIn / X / YouTube / TikTok / Pinterest profiles.
sponsored	True for sponsored placements.
position, search_term, search_location, page	Provenance for search rows.
detailsFetched, leadEnriched	Which enrichments ran for this row.
review_id, author, rating, date, text, provider, helpful_count	Review fields on business_reviews rows.

Webhooks

Every record is always written to the dataset. If you supply a webhook URL, each new record is additionally POSTed the moment it is saved — ideal for live lead alerts.

JSON format — the full record object:

{
    "featureType": "business_search",
    "business_name": "Fred Smith Plumbing & Heating",
    "phone": "(212) 744-1300",
    "website": "https://www.prestonkraus.com",
    "city": "New York",
    "state": "NY",
    "rating": 5,
    "categories": ["Plumbers"],
    "url": "https://www.superpages.com/new-york-ny/bpp/fred-smith-plumbing-heating-460765127"
}

Slack format — a ready-to-post message:

{ "text": ":office: *Fred Smith Plumbing & Heating*\n*Phone:* (212) 744-1300  •  *Website:* https://...  •  *Category:* Plumbers\n<https://www.superpages.com/...|Open on Superpages>" }

Delivery is best-effort: a failing webhook never stops the run or affects dataset writes.

Use it from AI agents (Apify MCP)

This Actor is available to AI agents through the Apify MCP server, so you can ask questions in natural language and get structured lead data back.

Example prompt for an agent:

"Find 25 roofing contractors in Austin, TX and 25 in Dallas, TX with their phone numbers, websites, and ratings — then give me a table sorted by rating."

The agent runs this Actor, and the results come back as structured records any downstream tool can consume.

FAQ

Do I need a proxy? Residential connections are recommended. The default configuration already selects a US residential route, and the Actor handles identity rotation for you at scale.

What happens on a free Apify plan? Runs are capped at 2 results so you can check data quality. Paid plans export everything your settings ask for.

How fresh is the data? Every run collects live records at run time — there is no cached list involved. Run it on a schedule for daily or weekly lead refresh.

Can I get emails? Yes — enable Add lead details and the Actor looks for public contact channels on each business's own website (emails and social profiles), merged into the same row.

What if a business has no website? It is still exported with everything else that is known. Nothing is ever filtered out for being incomplete.

Can I export one row per business even with enrichment on? Yes. Enrichment always merges into the same row (detailsFetched / leadEnriched), never a duplicate row.

How do I get only reviews? Turn off Business Search and enable Reviews & Ratings with your business URLs.

Support

Open an issue in the Actor's repository if you need a field added, another metro covered, or a different output shape for your CRM.