# US Local Business Opportunity Finder (`mobba/us-local-business-opportunity-finder`) Actor Find local businesses by niche and city, then score sales opportunities for agencies, SEO consultants, web designers, reputation managers, and B2B sales teams. - **URL**: https://apify.com/mobba/us-local-business-opportunity-finder.md - **Developed by:** [Catiusca Bonaldo](https://apify.com/mobba) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![US Local Business Opportunity Finder Banner](./banner.png) ## 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. ```json { "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: ```json { "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 ```json { "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. # Actor input Schema ## `niche` (type: `string`): Business type, service, or keyword to search for. Examples: med spa, dentist, HVAC, roofing company, law firm, restaurant. ## `location` (type: `string`): City, state, address, or local market to search in. Examples: Miami, FL; Dallas, TX; Phoenix, AZ. ## `maxResults` (type: `integer`): Maximum number of businesses to return. Start with 25-50 for testing. This MVP caps runs at 240 results. ## `lowReviewThreshold` (type: `integer`): Businesses below this review count receive a review-growth opportunity signal. ## `lowRatingThreshold` (type: `number`): Businesses below this Yelp rating receive a reputation-management opportunity signal. ## `sortResultsByScore` (type: `boolean`): Sort results from highest to lowest opportunity score before saving to the dataset. ## `checkWebsite` (type: `boolean`): When enabled, the Actor checks business-owned website URLs supplied through Website URL overrides. Yelp usually returns Yelp profile URLs, not business-owned website URLs. ## `websiteOverrides` (type: `object`): Optional JSON object mapping Yelp business IDs, aliases, or business names to website URLs. Example: {"Example Med Spa": "https://examplemedspa.com"}. ## `opportunityCriteria` (type: `array`): Signals used for scoring. Keep all selected for the broadest sales-opportunity scan. ## `radiusMeters` (type: `integer`): Optional Yelp radius from the location, from 1 to 40000 meters. Leave empty to let Yelp decide. ## `sortBy` (type: `string`): Yelp search sort suggestion. Best match is recommended for broad lead discovery. ## `yelpCategories` (type: `string`): Optional comma-separated Yelp category aliases, such as dentists, hvac, medspas, roofing. Leave empty to search by keyword only. ## `yelpAttributes` (type: `array`): Optional Yelp attribute filters, such as request\_a\_quote or reservation. Leave empty for broader discovery. ## `includeTechnicalFields` (type: `boolean`): Adds IDs, coordinates, image URLs, redirect URLs, and website error details. Keep off for clean sales spreadsheets. ## `websiteTimeoutSeconds` (type: `integer`): Timeout for each supplied website homepage check. ## `maxConcurrency` (type: `integer`): Maximum number of website checks running at the same time. ## `locale` (type: `string`): Yelp locale code used for API responses. ## Actor input object example ```json { "niche": "med spa", "location": "Miami, FL", "maxResults": 25, "lowReviewThreshold": 25, "lowRatingThreshold": 4, "sortResultsByScore": true, "checkWebsite": true, "websiteOverrides": {}, "opportunityCriteria": [ "missing_website", "site_unreachable", "no_https", "no_booking_signal", "no_contact_form_signal", "weak_cta_signal", "low_review_count", "low_rating", "missing_phone" ], "sortBy": "best_match", "yelpAttributes": [], "includeTechnicalFields": false, "websiteTimeoutSeconds": 12, "maxConcurrency": 8, "locale": "en_US" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "niche": "med spa", "location": "Miami, FL" }; // Run the Actor and wait for it to finish const run = await client.actor("mobba/us-local-business-opportunity-finder").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "niche": "med spa", "location": "Miami, FL", } # Run the Actor and wait for it to finish run = client.actor("mobba/us-local-business-opportunity-finder").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "niche": "med spa", "location": "Miami, FL" }' | apify call mobba/us-local-business-opportunity-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=mobba/us-local-business-opportunity-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "US Local Business Opportunity Finder", "description": "Find local businesses by niche and city, then score sales opportunities for agencies, SEO consultants, web designers, reputation managers, and B2B sales teams.", "version": "0.2", "x-build-id": "JY3WOH18yd7f0anvq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mobba~us-local-business-opportunity-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mobba-us-local-business-opportunity-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/mobba~us-local-business-opportunity-finder/runs": { "post": { "operationId": "runs-sync-mobba-us-local-business-opportunity-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/mobba~us-local-business-opportunity-finder/run-sync": { "post": { "operationId": "run-sync-mobba-us-local-business-opportunity-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "niche", "location", "maxResults" ], "properties": { "niche": { "title": "Business niche", "type": "string", "description": "Business type, service, or keyword to search for. Examples: med spa, dentist, HVAC, roofing company, law firm, restaurant." }, "location": { "title": "City or market", "type": "string", "description": "City, state, address, or local market to search in. Examples: Miami, FL; Dallas, TX; Phoenix, AZ." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 240, "type": "integer", "description": "Maximum number of businesses to return. Start with 25-50 for testing. This MVP caps runs at 240 results.", "default": 25 }, "lowReviewThreshold": { "title": "Low review threshold", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Businesses below this review count receive a review-growth opportunity signal.", "default": 25 }, "lowRatingThreshold": { "title": "Low rating threshold", "minimum": 1, "maximum": 5, "type": "number", "description": "Businesses below this Yelp rating receive a reputation-management opportunity signal.", "default": 4 }, "sortResultsByScore": { "title": "Sort by opportunity score", "type": "boolean", "description": "Sort results from highest to lowest opportunity score before saving to the dataset.", "default": true }, "checkWebsite": { "title": "Check supplied business websites", "type": "boolean", "description": "When enabled, the Actor checks business-owned website URLs supplied through Website URL overrides. Yelp usually returns Yelp profile URLs, not business-owned website URLs.", "default": true }, "websiteOverrides": { "title": "Website URL overrides", "type": "object", "description": "Optional JSON object mapping Yelp business IDs, aliases, or business names to website URLs. Example: {\"Example Med Spa\": \"https://examplemedspa.com\"}.", "default": {} }, "opportunityCriteria": { "title": "Opportunity criteria", "type": "array", "description": "Signals used for scoring. Keep all selected for the broadest sales-opportunity scan.", "items": { "type": "string", "enum": [ "missing_website", "site_unreachable", "no_https", "no_booking_signal", "no_contact_form_signal", "weak_cta_signal", "low_review_count", "low_rating", "missing_phone" ], "enumTitles": [ "No website URL available", "Website unreachable", "No HTTPS", "No booking signal", "No contact form signal", "Weak CTA signal", "Low review count", "Low rating", "Missing phone" ] }, "default": [ "missing_website", "site_unreachable", "no_https", "no_booking_signal", "no_contact_form_signal", "weak_cta_signal", "low_review_count", "low_rating", "missing_phone" ] }, "radiusMeters": { "title": "Search radius in meters", "minimum": 1, "maximum": 40000, "type": "integer", "description": "Optional Yelp radius from the location, from 1 to 40000 meters. Leave empty to let Yelp decide." }, "sortBy": { "title": "Yelp sort mode", "enum": [ "best_match", "rating", "review_count", "distance" ], "type": "string", "description": "Yelp search sort suggestion. Best match is recommended for broad lead discovery.", "default": "best_match" }, "yelpCategories": { "title": "Yelp category aliases", "type": "string", "description": "Optional comma-separated Yelp category aliases, such as dentists, hvac, medspas, roofing. Leave empty to search by keyword only." }, "yelpAttributes": { "title": "Yelp attributes", "type": "array", "description": "Optional Yelp attribute filters, such as request_a_quote or reservation. Leave empty for broader discovery.", "default": [], "items": { "type": "string" } }, "includeTechnicalFields": { "title": "Include technical/debug fields", "type": "boolean", "description": "Adds IDs, coordinates, image URLs, redirect URLs, and website error details. Keep off for clean sales spreadsheets.", "default": false }, "websiteTimeoutSeconds": { "title": "Website timeout seconds", "minimum": 3, "maximum": 60, "type": "integer", "description": "Timeout for each supplied website homepage check.", "default": 12 }, "maxConcurrency": { "title": "Maximum website concurrency", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum number of website checks running at the same time.", "default": 8 }, "locale": { "title": "Yelp locale", "type": "string", "description": "Yelp locale code used for API responses.", "default": "en_US" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```