# Google Maps Scraper

Scrape Google Maps business listings by keyword and location. Use it as a no-code template or via API/MCP. Export names, phones, ratings, and hours.

- Template page: [https://www.octoparse.com/template/google-maps-advanced-scraper](https://www.octoparse.com/template/google-maps-advanced-scraper)
- Categories: Maps, Lead Generation
- Status: `PUBLISHED`
- Run mode: `CLOUD`

## Pricing

Current price: **$2/1,000 lines**. Billing is based on output rows; an Octoparse subscription may be required.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from review pages, detail pages.

## Output

The current workflow extracts 79 fields, including `Additional_info`, `Address`, `CID`, `Categories`, `Category`, `City`, `Claim_This_Business`, `Country`, `Current_Status`, `Delivery`, `Description`, `FAQ1`, `FAQ10`, `FAQ2`, `FAQ3`, `FAQ4`, `FAQ5`, `FAQ6`, `FAQ7`, `FAQ8`, `FAQ9`, `Google_id`, `Image_1`, `Image_2`, `Image_3`, `Image_Categories`, `KG_MID`, `Language`, `Latitude`, `Located_in`, `Longitude`, `Main_image`, `Neighborhood`, `Next_status`, `Open_Time`, `Open_Time_Friday`, `Open_Time_Monday`, `Open_Time_Saturday`, `Open_Time_Sunday`, `Open_Time_Thursday`, `Open_Time_Tuesday`, `Open_Time_Wednesday`, `Page_URL`, `Phone`, `Place_id`, `Plus_code`, `Plus_code_URL`, `Popular_times_Friday`, `Popular_times_Monday`, `Popular_times_Saturday`, `Popular_times_Sunday`, `Popular_times_Thursday`, `Popular_times_Tuesday`, `Popular_times_Wednesday`, `Postal_Code`, `Price_Range`, `Rating`, `Review_Count`, `Review_keyword1`, `Review_keyword10`, `Review_keyword2`, `Review_keyword3`, `Review_keyword4`, `Review_keyword5`, `Review_keyword6`, `Review_keyword7`, `Review_keyword8`, `Review_keyword9`, `Reviews_Distribution`, `Reviews_Tags`, `Scraped_at`, `Search_Page_URL`, `State`, `Street`, `Tags`, `Title`, `Website`, `about`, `keyword`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Search Term (up to 10,000), Google Maps Language, Number of places to extract (per each search term) and start the template in cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Search Term (up to 10,000)

Required. Please avoid using synonyms or multiple variations of the same term (e.g., "café", "coffee shop", "coffeehouse"), as this can result in a large amount of duplicated data, leading to unnecessary resource usage and extra processing time. Keeping your search term specific and concise helps ensure cleaner and more efficient scraping results. Constraints: minItems=1; maxItems=10000; items.minLength=1; items.maxLength=10000.

### Google Maps Language

Optional. Optional. If left blank, English is used. Choose another language to localize categories, business status text, action labels, and other interface-derived values. This does not replace the Location field, which controls the geographic search area. Constraints: minLength=2; maxLength=32. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Number of places to extract (per each search term)

Optional. Optional. Set the maximum number of places to collect for each keyword. If left blank, the template will try to collect all available places, up to the system limit. Constraints: minimum=1, maximum=100000.

### Location

Required. City, region, or area to scrape Constraints: minLength=1; maxLength=10000.

### Get Q&As

Optional. Google Maps allows users to ask and answer questions about businesses and places. These Q&As often provide valuable insights beyond basic business info — such as details on services, parking, hours, or visitor experiences. If you need those information, please enable this option. Constraints: default=false.

## How to Use

# Google Maps Scraper

Octoparse Google Maps Scraper collects public business listing data from Google Maps for a search term, location, and page count. Run it as a no-code template, or call it through the [Octoparse API](https://www.octoparse.com/open-api) or the [Google Maps MCP server](https://www.octoparse.com/mcp/google-maps-mcp-server). Use it for local lead generation, market research, competitor analysis, and location intelligence.

Google caps each map view at roughly 120 results. The template uses Maps splitting: it divides the target area into overlapping grid points and queries each one. Its auto-zooming algorithm zooms in to add more search points, collecting up to 120 results per point beyond that cap. See [scraping Google Maps beyond the 120-result limit](https://www.octoparse.com/blog/scraping-google-maps).

## Pricing and limits

- $2 per 1,000 output lines; you are only charged for unique results.
- Duplicate rows created by overlapping grid points are filtered out at billing, so total usage depends on the unique records the task returns.
- Duplicate businesses may still appear in output; duplicate rows are not billed.
- One Location per task.
- Output is limited to public listing fields. Email addresses and review text are not listed output fields for this template.
- Ratings, opening hours, phone numbers, websites, popular times, and other fields can be empty when Google Maps does not display them.

## Input

Required:

- **Search Term:** business category or keyword to search on Google Maps.
- **Number of pages:** Google Maps result pages to process. Example: `50` for broader coverage.
- **Location:** one city, region, or area.

## Output

Structured listing-level records include public fields such as `Title`, `Category`, `Address`, `Phone`, `Website`, `Rating`, `Review_Count`, `Latitude`, `Longitude`, `Plus_code`, `Place_id`, `Google_id`, `Page_URL`, and `keyword`, plus media and opening-hours fields. `keyword` and location stay with each row.

## How to use

1. [Create an Octoparse account](https://www.octoparse.com/console/trial) or sign in with email, Google, Microsoft, Apple, or GitHub.
2. Open [Google Maps Scraper](https://www.octoparse.com/console/template/google-maps-advanced-scraper) and select **Try it!**
3. Enter **Search Term**, **Number of pages**, and one **Location**.
4. Start the task in a supported Octoparse run mode.
5. Review the returned business rows.
6. Export as CSV, Excel, or JSON.

## Tips

- Start with one focused **Search Term** and a representative **Location** so you can review output before scaling.
- Keep `keyword` and location values with exported rows to preserve search context.
- Avoid extremely small **Locations** because they can cause oversplitting.
- For multiple regions, duplicate the task and change **Location** in each copy.

## Not included / next steps

For reviewer names, review text, dates, likes, or replies, use [Google Maps Reviews Scraper](https://www.octoparse.com/template/google-maps-review-scraper-cloud). For email addresses or social profiles beyond `Phone` and `Website`, run exported `Page_URL` values through [Google Maps Email Finder](https://www.octoparse.com/template/google-maps-contact-scraper).

Collect only public data and follow applicable laws and Google's terms.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)
- [Google Maps Email Scraper & Extractor](https://www.octoparse.com/template/google-maps-contact-scraper)
- [Google Maps Leads Scraper](https://www.octoparse.com/template/google-maps-scraper-store-details-by-keyword)
- [Google Maps Listings Scraper (by URLs)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-url)

## Input Schema

```json
{
  "title": "Google Maps Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "search_Term": {
      "title": "Search Term (up to 10,000)",
      "description": "Please avoid using synonyms or multiple variations of the same term (e.g., \"café\", \"coffee shop\", \"coffeehouse\"), as this can result in a large amount of duplicated data, leading to unnecessary resource usage and extra processing time. Keeping your search term specific and concise helps ensure cleaner and more efficient scraping results.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "google_Maps_Language": {
      "title": "Google Maps Language",
      "description": "Optional. If left blank, English is used. Choose another language to localize categories, business status text, action labels, and other interface-derived values. This does not replace the Location field, which controls the geographic search area.",
      "type": "string",
      "minLength": 2,
      "maxLength": 32,
      "oneOf": [
        {
          "title": "English",
          "const": "en"
        },
        {
          "title": "Any language",
          "const": "auto"
        },
        {
          "title": "日本語",
          "const": "ja"
        },
        {
          "title": "Español",
          "const": "es"
        },
        {
          "title": "Français",
          "const": "fr"
        },
        {
          "title": "Deutsch",
          "const": "de"
        },
        {
          "title": "Italiano",
          "const": "it"
        },
        {
          "title": "한국어",
          "const": "ko"
        },
        {
          "title": "Dansk",
          "const": "da"
        }
      ],
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "number_of_places_to_extract": {
      "title": "Number of places to extract (per each search term)",
      "description": "Optional. Set the maximum number of places to collect for each keyword. If left blank, the template will try to collect all available places, up to the system limit.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "location": {
      "title": "Location",
      "description": "City, region, or area to scrape",
      "type": "string",
      "minLength": 1,
      "maxLength": 10000,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "get_Q&As": {
      "title": "Get Q&As",
      "description": "Google Maps allows users to ask and answer questions about businesses and places. These Q&As often provide valuable insights beyond basic business info — such as details on services, parking, hours, or visitor experiences. If you need those information, please enable this option.",
      "type": "boolean",
      "default": false,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "search_Term",
    "location"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Additional_info": {
      "type": "string",
      "description": ""
    },
    "Address": {
      "type": "string",
      "description": ""
    },
    "CID": {
      "type": "string",
      "description": ""
    },
    "Categories": {
      "type": "string",
      "description": ""
    },
    "Category": {
      "type": "string",
      "description": ""
    },
    "City": {
      "type": "string",
      "description": ""
    },
    "Claim_This_Business": {
      "type": "string",
      "description": ""
    },
    "Country": {
      "type": "string",
      "description": ""
    },
    "Current_Status": {
      "type": "string",
      "description": ""
    },
    "Delivery": {
      "type": "string",
      "description": ""
    },
    "Description": {
      "type": "string",
      "description": ""
    },
    "FAQ1": {
      "type": "string",
      "description": ""
    },
    "FAQ10": {
      "type": "string",
      "description": ""
    },
    "FAQ2": {
      "type": "string",
      "description": ""
    },
    "FAQ3": {
      "type": "string",
      "description": ""
    },
    "FAQ4": {
      "type": "string",
      "description": ""
    },
    "FAQ5": {
      "type": "string",
      "description": ""
    },
    "FAQ6": {
      "type": "string",
      "description": ""
    },
    "FAQ7": {
      "type": "string",
      "description": ""
    },
    "FAQ8": {
      "type": "string",
      "description": ""
    },
    "FAQ9": {
      "type": "string",
      "description": ""
    },
    "Google_id": {
      "type": "string",
      "description": ""
    },
    "Image_1": {
      "type": "string",
      "description": ""
    },
    "Image_2": {
      "type": "string",
      "description": ""
    },
    "Image_3": {
      "type": "string",
      "description": ""
    },
    "Image_Categories": {
      "type": "string",
      "description": ""
    },
    "KG_MID": {
      "type": "string",
      "description": ""
    },
    "Language": {
      "type": "string",
      "description": ""
    },
    "Latitude": {
      "type": "string",
      "description": ""
    },
    "Located_in": {
      "type": "string",
      "description": ""
    },
    "Longitude": {
      "type": "string",
      "description": ""
    },
    "Main_image": {
      "type": "string",
      "description": ""
    },
    "Neighborhood": {
      "type": "string",
      "description": ""
    },
    "Next_status": {
      "type": "string",
      "description": ""
    },
    "Open_Time": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Friday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Monday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Saturday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Sunday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Thursday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Tuesday": {
      "type": "string",
      "description": ""
    },
    "Open_Time_Wednesday": {
      "type": "string",
      "description": ""
    },
    "Page_URL": {
      "type": "string",
      "description": ""
    },
    "Phone": {
      "type": "string",
      "description": ""
    },
    "Place_id": {
      "type": "string",
      "description": ""
    },
    "Plus_code": {
      "type": "string",
      "description": ""
    },
    "Plus_code_URL": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Friday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Monday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Saturday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Sunday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Thursday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Tuesday": {
      "type": "string",
      "description": ""
    },
    "Popular_times_Wednesday": {
      "type": "string",
      "description": ""
    },
    "Postal_Code": {
      "type": "string",
      "description": ""
    },
    "Price_Range": {
      "type": "string",
      "description": ""
    },
    "Rating": {
      "type": "string",
      "description": ""
    },
    "Review_Count": {
      "type": "string",
      "description": ""
    },
    "Review_keyword1": {
      "type": "string",
      "description": ""
    },
    "Review_keyword10": {
      "type": "string",
      "description": ""
    },
    "Review_keyword2": {
      "type": "string",
      "description": ""
    },
    "Review_keyword3": {
      "type": "string",
      "description": ""
    },
    "Review_keyword4": {
      "type": "string",
      "description": ""
    },
    "Review_keyword5": {
      "type": "string",
      "description": ""
    },
    "Review_keyword6": {
      "type": "string",
      "description": ""
    },
    "Review_keyword7": {
      "type": "string",
      "description": ""
    },
    "Review_keyword8": {
      "type": "string",
      "description": ""
    },
    "Review_keyword9": {
      "type": "string",
      "description": ""
    },
    "Reviews_Distribution": {
      "type": "string",
      "description": ""
    },
    "Reviews_Tags": {
      "type": "string",
      "description": ""
    },
    "Scraped_at": {
      "type": "string",
      "description": ""
    },
    "Search_Page_URL": {
      "type": "string",
      "description": ""
    },
    "State": {
      "type": "string",
      "description": ""
    },
    "Street": {
      "type": "string",
      "description": ""
    },
    "Tags": {
      "type": "string",
      "description": ""
    },
    "Title": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    },
    "about": {
      "type": "string",
      "description": ""
    },
    "keyword": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Google Maps Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

No verified real input/output examples are currently available.

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `google-maps-advanced-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/google-maps-advanced-scraper.json)
- [Manifest](https://www.octoparse.com/templates/google-maps-advanced-scraper-manifest.json)
