# Google Maps Scraper — Places & Reviews (`muhammadafzal/google-maps-scraper`) Actor

Scrape Google Maps places with names, categories, phones, websites, hours, ratings, reviews, addresses, photos, and coordinates.

- **URL**: https://apify.com/muhammadafzal/google-maps-scraper.md
- **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community)
- **Categories:** Lead generation, MCP servers, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — Places & Reviews

Scrape Google Maps for local business data including names, addresses, phone numbers, websites, star ratings, review counts, business hours, GPS coordinates, photos, and categories. Returns CRM-ready structured JSON — every field typed and machine-readable so AI agents, lead gen tools, and analytics dashboards can use it directly.

Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools.

### Features

- **100 places in ~5 seconds** — pure API extraction, no browser overhead
- **Complete contact data** — name, address, phone, website, Google Maps URL
- **Ratings & reviews** — star rating (0–5), total review count, and review text snippets
- **Business hours** — structured day-by-day hours (e.g., `"Monday": "9AM–9PM"`) and open/closed status
- **GPS coordinates** — precise lat/lng for mapping, distance calculations, and clustering
- **Photos** — thumbnail and gallery image URLs for visual data pipelines
- **Price level** — `$`, `$$`, `$$$`, `$$$$` where available
- **Category tags** — primary and secondary business types (e.g., `"restaurant"`, `"Italian restaurant"`)
- **Rating filter** — exclude places below a minimum star rating
- **Multi-query support** — search dozens of keywords or locations in a single run
- **Location biasing** — pass GPS coordinates to prioritize nearby results
- **12-country localization** — country code and language filtering

### Use Cases

| Use Case | Description |
|----------|-------------|
| **B2B lead generation** | Find dentists, lawyers, restaurants, or any business type in any city with phone + website |
| **Competitor analysis** | Map all competitors in a market by category and location |
| **Local SEO audits** | Benchmark ratings, hours, and review counts across locations |
| **Sales prospecting** | Build targeted prospect lists with contact details for outreach campaigns |
| **Real estate research** | Find nearby amenities, services, and points of interest |
| **AI & LLM pipelines** | Feed structured location data to agents for search, comparison, and recommendation |

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `searchQueries` | `string[]` | `["coffee shops in Austin TX"]` | Keywords + location to search on Google Maps (e.g., "dentists in Chicago") |
| `maxResults` | `integer` | `20` | Max places to return per query (1–200) |
| `countryCode` | `string` | `"us"` | Two-letter country code for localized results |
| `languageCode` | `string` | `"en"` | Language for results |
| `lat` / `lng` | `number` | — | Optional GPS coordinates to bias results toward a specific location |
| `minRating` | `number` | `0` | Only return places at or above this star rating (0–5) |
| `includePhotos` | `boolean` | `true` | Include photo URLs in output |

### Output

Each record in the dataset represents one Google Maps place:

```json
{
  "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4",
  "title": "Sydney Opera House",
  "address": "Bennelong Point, Sydney NSW 2000, Australia",
  "phoneNumber": "+61 2 9250 7111",
  "website": "https://www.sydneyoperahouse.com",
  "rating": 4.7,
  "ratingCount": 89432,
  "latitude": -33.8568,
  "longitude": 151.2153,
  "type": "Performing arts theater",
  "types": ["performing_arts_theater", "tourist_attraction"],
  "priceLevel": null,
  "openingHours": {
    "Monday": "9AM–5PM",
    "Tuesday": "9AM–5PM",
    "Wednesday": "9AM–5PM",
    "Thursday": "9AM–5PM",
    "Friday": "9AM–8PM",
    "Saturday": "9AM–8PM",
    "Sunday": "10AM–5PM"
  },
  "description": "Iconic multi-venue performing arts centre...",
  "thumbnailUrl": "https://lh3.googleusercontent.com/...",
  "googleUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ...",
  "scrapedAt": "2025-08-01T12:00:00.000Z",
  "searchQuery": "landmarks in Sydney"
}
```

### API Usage

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('USERNAME/google-maps-scraper').call({
  searchQueries: ['plumbers in Dallas TX', 'HVAC contractors in Houston TX'],
  maxResults: 50,
  countryCode: 'us',
  minRating: 4.0,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Scraped ${items.length} businesses`);
```

### Pricing

This actor charges per result item returned.

| Volume | Estimated Cost |
|--------|---------------|
| 100 places | ~$0.10 |
| 1,000 places | ~$1.00 |
| 10,000 places | ~$10.00 |

### FAQ

**Q: Does this require a Google API key?**
No — this scraper uses Google's public Maps data. No API key needed.

**Q: What is the maximum results per query?**
Up to 200 results per query. For more results, split across multiple searches with different radius or location filters.

**Q: Are business hours always available?**
Business hours are included when Google has them. About 60–70% of listings include structured hours.

**Q: Can I search multiple cities at once?**
Yes — pass an array of `searchQueries` like `["dentists in Chicago", "dentists in New York"]`.

### What is Google Maps Scraper?

**Google Maps Scraper** turns the target data into structured, reusable results on Apify. Use it when you need repeatable collection for analysts, developers, agencies, researchers, and AI-agent workflows without maintaining a custom scraper or one-off integration. Run it manually, schedule recurring jobs, call it through the Apify API, or connect it to an AI agent through the Apify MCP server.

The Actor stores results in an Apify dataset, where they can be previewed and exported as JSON, CSV, Excel, XML, or RSS. Availability and completeness depend on the source, supplied inputs, public visibility, authentication requirements, and upstream rate limits.

### Use cases for Google Maps Scraper

- Build structured datasets for research, reporting, enrichment, or monitoring.
- Automate repetitive collection with schedules, webhooks, and API calls.
- Feed clean records into spreadsheets, databases, CRMs, BI tools, AI agents, or RAG pipelines.
- Track changes over time by running the same validated input on a schedule.
- Replace fragile manual copy-and-paste work with a reproducible Apify workflow.

### How to use Google Maps Scraper

1. Open the Actor input page and choose a focused, valid target.
2. Set a conservative result limit for the first run.
3. Start the Actor and inspect the dataset for coverage and field availability.
4. Export the results or connect the dataset to your downstream system.
5. Scale gradually and use scheduling, pagination, or proxies when supported.

#### Important input options

- `searchQueries` — Enter one or more search queries to find places on Google Maps (e.g., 'restaurants in Austin TX', 'plumbers in Chicago', 'hotels near Central Park'). Each query returns up to maxResults plac
- `locationCoords` — Optional GPS coordinates to bias search results. Format as 'latitude,longitude' (e.g., '40.7128,-74.0060' for NYC). Leave empty for general search.
- `maxResults` — Maximum number of places to return per search query. Default is 20. Set lower for quick lookups, higher for comprehensive searches (up to 200 per query).
- `countryCode` — Two-letter country code for search localization (e.g., 'us' for United States, 'gb' for United Kingdom).
- `languageCode` — Language code for search results (e.g., 'en' for English, 'es' for Spanish).
- `includePhotos` — Include thumbnail image URLs in output. Disable for smaller output size.
- `minRating` — Only return places with rating >= this value (0 = no filter). Set to 4.0 for highly-rated businesses.
- `maxRequestRetries` — Maximum number of retry attempts if a search request fails. Increase for reliability on unstable connections.

### API and automation example

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/google-maps-scraper').call({
  // Add the same input fields you use in the Apify Console.
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Related Apify Actors

Use these dedicated tools when a neighboring data source or workflow is a better match:

- [Instagram Followers & Following Scraper — With Cookies](https://apify.com/muhammadafzal/instagram-following-scraper)
- [Leads Finder Pro - B2B Leads with Emails \[Apollo Alternative\]](https://apify.com/muhammadafzal/leads-finder-pro)
- [Yellow Pages US Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-us-scraper)
- [Yellow Pages Australia Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-au-scraper)
- [OpenTable Restaurants, Ratings & Reviews Scraper](https://apify.com/muhammadafzal/opentable-scraper)
- [Etsy Scraper Pro — Products, Prices, Reviews & Shop Data](https://apify.com/muhammadafzal/etsy-scraper-pro)
- [Weather MCP Server — Forecast, Historical & Air Quality](https://apify.com/muhammadafzal/weather-mcp-server)
- [Shopify Store Scraper - Products, Reviews & Emails](https://apify.com/muhammadafzal/shopify-store-scraper)
- [🔧 USA Plumbers Scraper — Leads with Phone, Address & Website](https://apify.com/muhammadafzal/usa-plumbers-scraper)
- [Yellow Pages CA Scraper — Canadian Business Leads](https://apify.com/muhammadafzal/yellow-pages-ca-scraper)

### Frequently asked questions

#### How many results can I scrape with Google Maps Scraper?

The practical total depends on the source, input limits, pagination, available records, run timeout, and upstream restrictions. Start with a small run, verify the output, and increase the limit gradually.

#### Can I integrate Google Maps Scraper with other apps?

Yes. Use Apify integrations, webhooks, schedules, dataset exports, Make, Zapier, Google Sheets, cloud storage, or your own application.

#### Can I use Google Maps Scraper with the Apify API?

Yes. Start runs with the Apify REST API or an official Apify client, then retrieve records from the run's default dataset. Keep your API token in a secret or environment variable.

#### Can I use Google Maps Scraper through an MCP Server?

Yes. The Apify MCP server can expose the Actor to compatible AI clients and agents. Review the input and expected cost before allowing an autonomous workflow to run it at scale.

#### Do I need proxies?

It depends on the source and volume. Use the default configuration first. For larger or geographically sensitive jobs, select an appropriate proxy configuration only when the Actor supports it.

#### Is it legal to scrape this data?

Scraping rules vary by source, jurisdiction, data type, and intended use. Collect only data you are authorized to access, respect applicable terms and privacy laws, and avoid restricted or personal data misuse. This documentation is not legal advice.

#### Your feedback

If a field is missing, a source layout has changed, or you need a supported use case documented, open an issue on the Actor page with a reproducible input and run ID.

# Actor input Schema

## `searchQueries` (type: `array`):

Enter one or more search queries to find places on Google Maps (e.g., 'restaurants in Austin TX', 'plumbers in Chicago', 'hotels near Central Park'). Each query returns up to maxResults places. Combine with locationCoords to bias results toward a specific area.

## `locationCoords` (type: `string`):

Optional GPS coordinates to bias search results. Format as 'latitude,longitude' (e.g., '40.7128,-74.0060' for NYC). Leave empty for general search.

## `maxResults` (type: `integer`):

Maximum number of places to return per search query. Default is 20. Set lower for quick lookups, higher for comprehensive searches (up to 200 per query).

## `countryCode` (type: `string`):

Two-letter country code for search localization (e.g., 'us' for United States, 'gb' for United Kingdom).

## `languageCode` (type: `string`):

Language code for search results (e.g., 'en' for English, 'es' for Spanish).

## `includePhotos` (type: `boolean`):

Include thumbnail image URLs in output. Disable for smaller output size.

## `minRating` (type: `number`):

Only return places with rating >= this value (0 = no filter). Set to 4.0 for highly-rated businesses.

## `maxRequestRetries` (type: `integer`):

Maximum number of retry attempts if a search request fails. Increase for reliability on unstable connections.

## Actor input object example

```json
{
  "searchQueries": [
    "coffee shops near Central Park"
  ],
  "locationCoords": "",
  "maxResults": 20,
  "countryCode": "us",
  "languageCode": "en",
  "includePhotos": true,
  "minRating": 0,
  "maxRequestRetries": 3
}
```

# Actor output Schema

## `results` (type: `string`):

Link to the dataset containing all extracted Google Maps places with full metadata, reviews, and photos.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "coffee shops near Central Park"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("muhammadafzal/google-maps-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": ["coffee shops near Central Park"] }

# Run the Actor and wait for it to finish
run = client.actor("muhammadafzal/google-maps-scraper").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 '{
  "searchQueries": [
    "coffee shops near Central Park"
  ]
}' |
apify call muhammadafzal/google-maps-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=muhammadafzal/google-maps-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/Osrcq5fVcfchVlxsJ/builds/ZguoY2JaSaraIdFhp/openapi.json