Local Business Opportunity Finder

Find local businesses by niche and market, then prioritize outreach opportunities for agencies, SEO consultants, web designers, reputation managers, and B2B sales teams.

This Actor is designed for one practical job: turn local business search results into a prioritized prospect list.

Instead of only returning business names, it highlights likely commercial angles such as low review count, low rating, missing phone data, weak digital presence signals, and website improvement opportunities when website data is available.

What can you use it for?

Use this Actor to find prospects for:

• Local SEO services
• Review generation and reputation management
• Website redesigns and starter websites
• Online booking setup
• Quote-request and lead-capture funnels
• Conversion cleanup for local business websites
• B2B prospecting for agencies, freelancers, and consultants

Example niches:

• med spa
• dentist
• roofing company
• HVAC
• law firm
• restaurant
• chiropractor
• plumber
• landscaper
• auto repair

Example locations:

• Miami, FL
• Dallas, TX
• Phoenix, AZ
• Austin, TX
• Los Angeles, CA
• Chicago, IL

What this Actor returns

The default output is intentionally lean and spreadsheet-friendly:

• business_name
• niche
• market
• city
• state
• phone
• rating
• review_count
• opportunity_score
• opportunity_level
• primary_opportunity
• opportunity_signals
• recommended_pitch_angle
• website_url
• yelp_url
• notes

Advanced website and diagnostic fields can be included by enabling includeTechnicalFields.

Input

Provide a niche, location, and maximum number of results.

{
  "niche": "med spa",
  "location": "Miami, FL",
  "maxResults": 25,
  "lowReviewThreshold": 25,
  "lowRatingThreshold": 4,
  "sortResultsByScore": true,
  "checkWebsite": true,
  "websiteOverrides": {}
}

Input fields

Field	Description
niche	Business type or search term, such as dentist, med spa, HVAC, or law firm.
location	City, state, or market to search, such as Miami, FL or Dallas, TX.
maxResults	Maximum number of businesses to return.
lowReviewThreshold	Review count below this number will be treated as an opportunity signal.
lowRatingThreshold	Rating below this number will be treated as an opportunity signal.
sortResultsByScore	When enabled, results are sorted by highest opportunity score first.
checkWebsite	When enabled, website checks run when a business-owned website URL is available.
websiteOverrides	Optional manual website mapping for businesses you want to check.

Website URL limitation

This MVP uses Yelp as the first data source. Yelp search results commonly include Yelp public profile URLs, but not always verified business-owned website URLs.

Because of that, website_url may be empty for many results.

This Actor handles that transparently:

• It does not invent website URLs.
• It treats missing business-owned website data as a possible digital presence opportunity.
• It runs website checks only when a business-owned URL is available.

Website overrides

Use websiteOverrides when you already know a business website and want the Actor to check it.

You can map by Yelp business ID, Yelp alias, or business name:

{
  "websiteOverrides": {
    "example-med-spa-miami": "https://examplemedspa.com",
    "Example Med Spa": "https://examplemedspa.com"
  }
}

When a website is available, the Actor can check for:

• HTTPS
• Booking, appointment, schedule, reservation, estimate, or quote signals
• Contact form/contact page signals
• Strong CTA phrases such as book now, call now, get a quote, or free consultation

Opportunity score

The Actor calculates opportunity_score from 0 to 100 using simple research signals.

Examples of opportunity signals:

Signal	What it can indicate
Low review count	Possible fit for review generation or local reputation campaigns
Low rating	Possible fit for reputation management and customer experience repair
No website URL available	Possible fit for website, SEO, landing page, or digital presence services
Website unreachable	Possible technical cleanup opportunity
No HTTPS	Trust and technical improvement opportunity
No booking signal	Booking, appointment, quote-request, or lead-capture opportunity
No contact form signal	Conversion and contact cleanup opportunity
Weak CTA signal	Homepage conversion opportunity
Missing phone	Contact data cleanup opportunity

opportunity_level is derived from the score:

• High: 65+
• Medium: 35-64
• Low: below 35

Output example

{
  "business_name": "Icon Cosmetic Center",
  "niche": "med spa",
  "market": "Miami, FL",
  "city": "Miami",
  "state": "FL",
  "phone": "+17862337080",
  "rating": 1.6,
  "review_count": 22,
  "opportunity_score": 47,
  "opportunity_level": "Medium",
  "primary_opportunity": "Reputation and reviews",
  "opportunity_signals": "No business-owned website URL available from current source; Low review count under 25; Rating below 4",
  "recommended_pitch_angle": "Offer a quick website audit and a conversion-focused starter website for local lead generation. Offer review generation and local reputation growth campaigns. Lead with reputation management, review response workflows, and customer experience fixes.",
  "website_url": "",
  "yelp_url": "https://www.yelp.com/biz/example-med-spa-miami",
  "notes": "No verified business-owned website URL was available from the current source. Validate manually before outreach. Website checks skipped: no business-owned website URL available."
}

How to use the results

Recommended workflow:

1. Search a niche and market.
2. Sort by opportunity_score.
3. Review the highest-scoring businesses first.
4. Open the Yelp profile and manually validate the business.
5. Check whether the business has a real website, Google Business Profile, ads, or weak conversion flow.
6. Use recommended_pitch_angle as a starting point for outreach.
7. Export to CSV, Excel, or JSON and enrich your prospect list as needed.

This Actor is for research and prioritization. Always review prospects manually before contacting them.

MVP limitations

• Yelp may not return businesses without reviews.
• Search result availability depends on Yelp API behavior and market coverage.
• Yelp commonly returns Yelp public profile URLs, not business-owned website URLs.
• Website checks only run when a business-owned URL is available.
• Scoring is heuristic and should not be treated as a guarantee that a business needs or wants services.
• Users should verify all prospects before outreach.

Support

If a run fails or returns fewer results than expected, check:

• niche and location are filled correctly
• maxResults is within the supported range
• The selected market has enough matching businesses
• Website override values are valid URLs

If results have empty website_url, this is expected for the current Yelp-based MVP.