# Google Maps Places Scraper - Fast & Cheap Bulk Places (`johnvc/google-maps-places-api`) Actor Fast, low-cost Google Maps places scraper. Get business names, addresses, phone numbers, websites, ratings, categories, coordinates, and opening hours as clean structured JSON. Built for bulk research and dataset building. - **URL**: https://apify.com/johnvc/google-maps-places-api.md - **Developed by:** [John](https://apify.com/johnvc) (community) - **Categories:** SEO tools, Developer tools, Travel - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results 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.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 ## Google Maps Places Scraper - Fast & Cheap Bulk Places Pull Google Maps places in bulk and get clean, structured JSON, fast and cheap. Business names, addresses, phone numbers, websites, ratings, categories, GPS coordinates, opening hours, price levels, and Google Place IDs. Search by keyword and location, run many searches at once, and export thousands of places. This is the **Lite** option: just the place data, fast, no enrichment and no fuss. It talks to a structured search API instead of driving a slow, breakable headless browser, so it is quick and reliable. If you need emails, reviews, or popular times, this is not the tool - see the comparison below. ### What you get One clean row per place: - Name, full address, latitude, longitude - Rating and review count - Category (`type`) and all categories (`types`) - Phone number and website - Opening hours - Price level and a short description - Photo thumbnail, plus Google `cid`, `fid`, and `placeId` ### What you do NOT get - Emails and contact discovery - Individual reviews and review text - Popular times / busyness graphs - Photo galleries, owner info, social links Need those? Use a dedicated lead-generation or enrichment scraper. This actor is the fast, cheap complement for everyone who just needs the place data. ### When to use this actor | | This actor (Lite) | Full enrichment scrapers | |---|---|---| | Price | $0.80 - $2.00 / 1,000 places | $0.76 - $4.00 / 1,000 places | | Emails, reviews, popular times | Not included | Included | | Speed | API-based, fast | Browser-based, slower | | Best for | Bulk research, datasets, location intelligence, ML training | Lead generation, sales prospecting | Rule of thumb: **bulk place data → this actor; sales enrichment → a full enrichment scraper.** ### Pricing Pay-per-result: you are charged only for the **unique places** returned (duplicates across pages are removed before billing). The per-place price scales down with your Apify plan: | Plan | Per place | Per 1,000 places | |---|---|---| | Free | $0.0020 | $2.00 | | Bronze | $0.0017 | $1.70 | | Silver | $0.0014 | $1.40 | | Gold | $0.0012 | $1.20 | | Platinum | $0.0010 | $1.00 | | Diamond | $0.0008 | $0.80 | No per-run fee, no monthly minimum. You only pay for places you receive. ### Input | Field | Type | Description | |-------|------|-------------| | `searchTerms` | array of strings | One or more searches, e.g. `coffee shops in Austin, TX`. Each is searched independently. Required. | | `location` | string | Optional place to focus every search term on, e.g. `Austin, TX, United States`. | | `maxResultsPerSearch` | integer | Places per search term. Minimum 20, default 20. | | `language` | string | Optional language code, e.g. `en`, `es`, `fr`. | #### Example input ```json { "searchTerms": ["coffee shops in Austin, TX", "bookstores in Austin, TX"], "location": "Austin, TX, United States", "maxResultsPerSearch": 40 } ```` ### Sample output ```json { "searchTerm": "coffee shops in Austin, TX", "position": 1, "title": "Epoch Coffee", "address": "221 W N Loop Blvd, Austin, TX 78751", "latitude": 30.3186037, "longitude": -97.7245402, "rating": 4.5, "ratingCount": 2481, "priceLevel": "$1-10", "type": "Coffee shop", "types": ["Coffee shop"], "phoneNumber": "(512) 454-3762", "website": "https://www.epochcoffee.com/", "description": "Cool, vibrant small-chain cafe featuring nibbles, tea & carefully brewed espresso drinks.", "openingHours": { "Monday": "12 AM-11:30 PM", "Tuesday": "6 AM-12 AM", "Wednesday": "Open 24 hours" }, "thumbnailUrl": "https://lh3.googleusercontent.com/...", "cid": "140078896924485689", "fid": "0x8644ca6bc309e81b:0x1f1a903bbb66839", "placeId": "ChIJG-gJw2vKRIYROWi2uwOp8QE" } ``` ### How to get started 1. Open [Google Maps Places Scraper on the Apify Store](https://apify.com/johnvc/google-maps-places-api?fpr=9n7kx3). 2. Enter one or more `searchTerms` (add a `location` to focus them). 3. Set `maxResultsPerSearch`, then run the Actor. 4. Export the dataset as JSON, CSV, or Excel, or pull it from the API. ### Run from the API ```bash curl -X POST "https://api.apify.com/v2/acts/johnvc~google-maps-places-api/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"searchTerms":["coffee shops in Austin, TX"],"maxResultsPerSearch":40}' ``` ### Use from an AI agent (MCP) This Actor is compatible with the Model Context Protocol (MCP). Connect your agent to the Apify MCP server at `https://mcp.apify.com` and it becomes a callable tool for requests like "find every hardware store in Denver." If you run agents from [Claude Code](https://claude.ai/referral/uIlpa7nPLg) (free trial) or [Claude Cowork](https://claude.ai/referral/uIlpa7nPLg) (free trial), add the Apify MCP server and call this Actor directly. ### FAQ **How do I get emails?** This actor does not return emails. Use a dedicated lead-generation or enrichment scraper. **Does it return reviews or popular times?** No. It returns place and business listing data only. For reviews, use a reviews scraper; for popular times, use a full enrichment scraper. **How many places per search?** Set `maxResultsPerSearch` (minimum 20). Results come in pages of about 20 and are trimmed to your count; a search stops early when the area runs out of places, so you only pay for what exists. **Why did I get fewer results than I asked for?** `maxResultsPerSearch` is a ceiling, not a guarantee. Some areas simply have fewer matching places. **Can I search many areas at once?** Yes. Pass multiple `searchTerms`; each is searched independently and tagged with its source term in the output. Last Updated: 2026.05.30 # Actor input Schema ## `searchTerms` (type: `array`): One or more searches, for example 'coffee shops in Austin, TX' or 'dentists in 90210'. Each term is searched independently. Include a location here, or set the Location field below to apply one to every term. ## `location` (type: `string`): Optional place to focus all search terms on, for example 'Austin, TX, United States'. Leave blank if your terms already include a location. ## `maxResultsPerSearch` (type: `integer`): How many places to return per search term. Results come in pages of about 20; the Actor pulls just enough pages to reach this count, then stops early when a term runs out of places. Minimum 20. ## `language` (type: `string`): Optional two-letter language code for results, for example 'en', 'es', 'fr'. ## Actor input object example ```json { "searchTerms": [ "coffee shops in Austin, TX" ], "maxResultsPerSearch": 20 } ``` # Actor output Schema ## `places` (type: `string`): All place records stored in the default dataset, one item per unique place. # 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 = { "searchTerms": [ "coffee shops in Austin, TX" ] }; // Run the Actor and wait for it to finish const run = await client.actor("johnvc/google-maps-places-api").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 = { "searchTerms": ["coffee shops in Austin, TX"] } # Run the Actor and wait for it to finish run = client.actor("johnvc/google-maps-places-api").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 '{ "searchTerms": [ "coffee shops in Austin, TX" ] }' | apify call johnvc/google-maps-places-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=johnvc/google-maps-places-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Places Scraper - Fast & Cheap Bulk Places", "description": "Fast, low-cost Google Maps places scraper. Get business names, addresses, phone numbers, websites, ratings, categories, coordinates, and opening hours as clean structured JSON. Built for bulk research and dataset building.", "version": "0.0", "x-build-id": "tUChCZQ9SqGO8dL31" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/johnvc~google-maps-places-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-johnvc-google-maps-places-api", "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/johnvc~google-maps-places-api/runs": { "post": { "operationId": "runs-sync-johnvc-google-maps-places-api", "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/johnvc~google-maps-places-api/run-sync": { "post": { "operationId": "run-sync-johnvc-google-maps-places-api", "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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search Terms", "minItems": 1, "type": "array", "description": "One or more searches, for example 'coffee shops in Austin, TX' or 'dentists in 90210'. Each term is searched independently. Include a location here, or set the Location field below to apply one to every term.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional place to focus all search terms on, for example 'Austin, TX, United States'. Leave blank if your terms already include a location." }, "maxResultsPerSearch": { "title": "Maximum Results Per Search", "minimum": 20, "maximum": 1000, "type": "integer", "description": "How many places to return per search term. Results come in pages of about 20; the Actor pulls just enough pages to reach this count, then stops early when a term runs out of places. Minimum 20.", "default": 20 }, "language": { "title": "Language", "type": "string", "description": "Optional two-letter language code for results, for example 'en', 'es', 'fr'." } } }, "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 } } } } } } } } } } ```