# Local Business Lead Finder — Pay Per Result (`xtech/local-business-lead-finder`) Actor Find structured local business leads on Google Maps by service, brand, or location, with transparent per-result pricing and unbilled empty-search diagnostics. Pay only for validated business leads. - **URL**: https://apify.com/xtech/local-business-lead-finder.md - **Developed by:** [Xtech](https://apify.com/xtech) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.40 / 1,000 business leads This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Google Maps Scraper - Business Leads & Listings finds local businesses by service, category, brand, and location. Turn searches such as “coffee shops in Berlin” or “independent gyms in Austin” into structured business data for prospecting, local research, and competitive analysis. Independent tool. Not affiliated with, endorsed by, or sponsored by Google. ### What can the Google Maps Scraper do? Add up to 100 searches in one run and choose how many businesses to collect for each search. Use natural search phrases that combine what you need with a city, district, region, or country. The supplied query stays attached to every result, so you can compare markets or segment an exported lead list later. ### Google Maps business data Each saved row represents one business listing and can include: - Business name and category - Rating and visible review count - Address and phone number when shown - Public website when shown - Direct Google Maps place link - Search query and collection timestamp Download the results as JSON, CSV, or Excel, or connect them to your CRM, spreadsheet, reporting, or enrichment workflow. ### How to find business leads on Google Maps 1. Add one or more focused business searches. 2. Include a location in every query for more relevant results. 3. Set the maximum businesses to save per search. 4. Choose the two-letter display language and start the run. #### Example input ```json { "searches": [ "coffee shops in Berlin", "independent gyms in Austin, Texas" ], "maxResultsPerSearch": 20, "language": "en" } ```` ### Business lead and market research use cases - Build local prospect lists for sales research - Compare competitors across cities or districts - Review ratings and review volume for local SEO analysis - Discover suppliers, partners, franchises, or service providers - Study market coverage before opening a new location - Create repeatable business-directory exports for internal workflows ### Pricing This Actor uses result-based pricing. You pay for business listings successfully saved to the dataset. Searches that return no usable listings do not create paid business rows. Set a modest result limit while testing a query, then increase it when the results match your target market. ### Frequently asked questions #### Can I run several locations together? Yes. Add a separate query for each location. Every row includes the search that produced it. #### Does every listing include a phone and website? No. These fields are returned only when they are visible for that business. #### Does this Actor collect reviews? It returns the visible rating and review count, not individual review text or reviewer profiles. ### Limitations Google Maps controls which businesses, fields, and ranking order appear for every search. Results may vary by language, location wording, and collection time. Broad searches can include less relevant places, so specific service-and-location phrases work best. This Actor does not enrich listings with emails, scrape individual reviews, or guarantee complete coverage of every business in an area. # Actor input Schema ## `searches` (type: `array`): Add a business category, brand, or service together with a location. For example: dentists in Austin, Texas. ## `maxResultsPerSearch` (type: `integer`): Maximum business listings to save for every supplied search. ## `language` (type: `string`): Two-letter language code used when opening Google Maps. Use en for English. ## Actor input object example ```json { "searches": [ "coffee shops in Berlin" ], "maxResultsPerSearch": 20, "language": "en" } ``` # Actor output Schema ## `businesses` (type: `string`): Structured Google Maps business listings collected from the supplied searches. ## `sourceResults` (type: `string`): Unbilled source outcomes, such as empty searches or temporarily unavailable pages. # 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 = { "searches": [ "coffee shops in Berlin" ] }; // Run the Actor and wait for it to finish const run = await client.actor("xtech/local-business-lead-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 = { "searches": ["coffee shops in Berlin"] } # Run the Actor and wait for it to finish run = client.actor("xtech/local-business-lead-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 '{ "searches": [ "coffee shops in Berlin" ] }' | apify call xtech/local-business-lead-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtech/local-business-lead-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Local Business Lead Finder — Pay Per Result", "description": "Find structured local business leads on Google Maps by service, brand, or location, with transparent per-result pricing and unbilled empty-search diagnostics. Pay only for validated business leads.", "version": "0.1", "x-build-id": "q7MZdwy56Uj2Qdm6s" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtech~local-business-lead-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtech-local-business-lead-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/xtech~local-business-lead-finder/runs": { "post": { "operationId": "runs-sync-xtech-local-business-lead-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/xtech~local-business-lead-finder/run-sync": { "post": { "operationId": "run-sync-xtech-local-business-lead-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": [ "searches" ], "properties": { "searches": { "title": "Google Maps searches", "minItems": 1, "maxItems": 100, "type": "array", "description": "Add a business category, brand, or service together with a location. For example: dentists in Austin, Texas.", "items": { "type": "string", "minLength": 1 } }, "maxResultsPerSearch": { "title": "Maximum businesses per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum business listings to save for every supplied search.", "default": 20 }, "language": { "title": "Google Maps language", "pattern": "^[a-zA-Z]{2}$", "type": "string", "description": "Two-letter language code used when opening Google Maps. Use en for English.", "default": "en" } } }, "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 } } } } } } } } } } ```