# Google Maps Listings Scraper (by URLs)

Scrape Google Maps listing pages by URL. Extract business names, ratings, addresses, categories, and place URLs for analysis, lead sourcing, or further data extraction — no coding needed.

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

## Pricing

Free.

## 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 detail pages.

## Output

The current workflow extracts 17 fields, including `Address`, `Category`, `Current_status`, `Detail_URL`, `Keyword`, `Latitude`, `Longitude`, `Name`, `Next_status`, `Original_URL`, `Price_range`, `Rating`, `Review_count`, `Scraped_at`, `Tags`, `Telephone`, `Website`.

## 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 Target URLs (up to 5,000) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Target URLs (up to 5,000)

Required. Enter one or multiple URLs to scrape. Supports up to 5,000 URLs per run, one per line. Constraints: minItems=1; maxItems=5000; items.minLength=1; items.maxLength=500000.

## How to Use

# Google Maps Listing Page Scraper – Usage Guide

Extract all visible business listings from Google Maps search result pages. Input listing-page URLs and get structured data.

## Input Requirements

- **Supported URLs**: Google Maps search result pages only (URLs that show multiple businesses in a left panel).  
  Examples:  
  `https://www.google.com/maps/search/gas+station+in+boston/@42.3494448,-71.1198434,13z/data=!3m1!4b1`  
  `https://www.google.com/maps/search/coffee+shop+in+california/@39.7448521,-130.4137933,5z/data=!3m1!4b1`  
  `https://www.google.com/maps/search/restaurants+in+new+york/@40.7234037,-74.0192536,14z/data=!3m1!4b1`
- **Not supported**: individual business place URLs (use a Place Details scraper instead).
- **Limit**: up to 5,000 URLs per run, one per line.

## How to Use

1. **Start the template** – Click **"Try it!"** or **"Start"** to load the scraper.
2. **Enter parameters** – On the input screen, provide your target URLs (required).
3. **Run the scraper** – Click **"Start"** and select an available run mode. Octoparse will automatically browse, scroll, and extract data.
4. **Handle interruptions** – If a CAPTCHA appears, pause the task, solve it manually, then resume.
5. **Export data** – Go to the output section, review, and export as CSV, Excel, or JSON.

## Important Notes

- **Maximize the scraping window** – A smaller window may cause missing listings or fields.
- **Dynamic loading** – Google Maps loads results based on scroll and screen size. Let the task fully scroll before stopping. Do not switch tabs or resize during execution.
- **Empty fields** – Phone numbers, websites, and emails are extracted only if Google Maps displays them on the listing page. Some business categories do not show contact info at the listing level. This is expected behavior, not a scraping error.
- **For detailed review data** – Use the Google Maps Reviews Scraper. For richer contact data (website, email), use the Google Maps Leads Scraper.
- **Large projects** – Split URLs into multiple runs if exceeding 5,000, export incrementally, and combine datasets later.

## 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 Finder (by URLs)](https://www.octoparse.com/template/google-maps-email-finder-by-urls)
- [Google Hotel Scraper (by URLs)](https://www.octoparse.com/template/google-hotel-scraper-by-urls)
- [Google Maps Reviews Scraper (by Reviewer)](https://www.octoparse.com/template/google-maps-reviews-scraper-by-user-page)
- [Google Maps Email Finder (by keyword)](https://www.octoparse.com/template/google-maps-email-finder-by-keyword)

## Input Schema

```json
{
  "title": "Google Maps Listings Scraper (by URLs) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "target_URLs": {
      "title": "Target URLs (up to 5,000)",
      "description": "Enter one or multiple URLs to scrape. Supports up to 5,000 URLs per run, one per line.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500000
      },
      "minItems": 1,
      "maxItems": 5000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "target_URLs"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "target_URLs": [
    "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu"
  ]
}
```

Example 2

```json
{
  "target_URLs": [
    "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu"
  ]
}
```

Example 3

```json
{
  "target_URLs": [
    "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.61600,-58.45800,15z/data=!3m1!4b1?hl=es-419",
    "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.61600,-58.43000,15z/data=!3m1!4b1?hl=es-419",
    "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.61600,-58.40200,15z/data=!3m1!4b1?hl=es-419",
    "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.58800,-58.45800,15z/data=!3m1!4b1?hl=es-419",
    "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.58800,-58.43000,15z/data=!3m1!4b1?hl=es-419"
  ]
}
```

Example 4

```json
{
  "target_URLs": [
    "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Address": {
      "type": "string",
      "description": ""
    },
    "Category": {
      "type": "string",
      "description": ""
    },
    "Current_status": {
      "type": "string",
      "description": ""
    },
    "Detail_URL": {
      "type": "string",
      "description": ""
    },
    "Keyword": {
      "type": "string",
      "description": ""
    },
    "Latitude": {
      "type": "string",
      "description": ""
    },
    "Longitude": {
      "type": "string",
      "description": ""
    },
    "Name": {
      "type": "string",
      "description": ""
    },
    "Next_status": {
      "type": "string",
      "description": ""
    },
    "Original_URL": {
      "type": "string",
      "description": ""
    },
    "Price_range": {
      "type": "string",
      "description": ""
    },
    "Rating": {
      "type": "string",
      "description": ""
    },
    "Review_count": {
      "type": "string",
      "description": ""
    },
    "Scraped_at": {
      "type": "string",
      "description": ""
    },
    "Tags": {
      "type": "string",
      "description": ""
    },
    "Telephone": {
      "type": "string",
      "description": ""
    },
    "Website": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Google Maps Listings Scraper (by URLs) 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

Example 1

```json
{
  "Address": "",
  "Category": "4-star hotel",
  "Current_status": "",
  "Detail_URL": "https://www.google.com/maps/place/Four+Seasons+Hotel+Miami/data=!4m10!3m9!1s0x88d9b680c8ba8b07:0x494fd6ac4a57e74a!5m2!4m1!1i2!8m2!3d25.7589641!4d-80.1920843!16zL20vMDQzcGti!19sChIJB4u6yIC22YgRSudXSqzWT0k?authuser=0&hl=en&g_ep=EgoyMDI2MTExMC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "resorts cerca de Miami, Florida, EE. UU.",
  "Latitude": "25.7589641",
  "Longitude": "-80.1920843",
  "Name": "$598",
  "Next_status": "",
  "Original_URL": "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu",
  "Price_range": "",
  "Rating": "4.7",
  "Review_count": "2,844",
  "Scraped_at": "2026-11-16 22:50:13",
  "Tags": " \n\nPool\n\nSpa\n\nHot tub\n\nFree Wi-Fi\n \nDEAL\n15% less than usual",
  "Telephone": "",
  "Website": ""
}
```

Example 2

```json
{
  "Address": "",
  "Category": "4-star hotel",
  "Current_status": "",
  "Detail_URL": "https://www.google.com/maps/place/Four+Seasons+Hotel+Miami/data=!4m10!3m9!1s0x88d9b680c8ba8b07:0x494fd6ac4a57e74a!5m2!4m1!1i2!8m2!3d25.7589641!4d-80.1920843!16zL20vMDQzcGti!19sChIJB4u6yIC22YgRSudXSqzWT0k?authuser=0&hl=en&g_ep=EgoyMDI2MTExMC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "resorts cerca de Miami, Florida, EE. UU.",
  "Latitude": "25.7589641",
  "Longitude": "-80.1920843",
  "Name": "Four Seasons Hotel Miami",
  "Next_status": "",
  "Original_URL": "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu",
  "Price_range": "",
  "Rating": "4.7",
  "Review_count": "2,844",
  "Scraped_at": "2026-11-16 22:46:38",
  "Tags": " \n\nPool\n\nSpa\n\nHot tub\n\nFree Wi-Fi\n \nDEAL\n15% less than usual",
  "Telephone": "",
  "Website": ""
}
```

Example 3

```json
{
  "Address": "Aráoz 282",
  "Category": "Guardería canina",
  "Current_status": "Cerrado",
  "Detail_URL": "https://www.google.com/maps/place/Naricitas+Frias+Capital+Federal/data=!4m7!3m6!1s0x95bcca73176b0bd5:0xca496ec77a8ee5b1!8m2!3d-34.6006718!4d-58.4385101!16s%2Fg%2F11hcsdsx7j!19sChIJ1QtrF3PKvJURseWOesduSco?authuser=0&hl=es-419&g_ep=EgoyMDI2MTExMC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Guarderia canina hotel mascotas",
  "Latitude": "-34.6006718",
  "Longitude": "-58.4385101",
  "Name": "Naricitas Frias Capital Federal",
  "Next_status": " · Abre a las 8:30 a.m.",
  "Original_URL": "https://www.google.com/maps/search/Guarderia%20canina%20hotel%20mascotas/@-34.61600,-58.45800,15z/data=!3m1!4b1?hl=es-419",
  "Price_range": "",
  "Rating": "4.2",
  "Review_count": "131",
  "Scraped_at": "2026-11-16 06:42:49",
  "Tags": "",
  "Telephone": "",
  "Website": ""
}
```

Example 4

```json
{
  "Address": "",
  "Category": "5-star hotel",
  "Current_status": "",
  "Detail_URL": "https://www.google.com/maps/place/InterContinental+Miami+by+IHG/data=!4m10!3m9!1s0x88d9b4276878ddbb:0x5bb1fcd840d2173c!5m2!4m1!1i2!8m2!3d25.7721907!4d-80.1859031!16s%2Fm%2F027tddq!19sChIJu914aCe02YgRPBfSQNj8sVs?authuser=0&hl=en&g_ep=EgoyMDI2MTExMC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "resorts cerca de Miami, Florida, EE. UU.",
  "Latitude": "25.7721907",
  "Longitude": "-80.1859031",
  "Name": "InterContinental Miami by IHG",
  "Next_status": "",
  "Original_URL": "https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu",
  "Price_range": "",
  "Rating": "4.5",
  "Review_count": "8,029",
  "Scraped_at": "2026-11-16 00:14:06",
  "Tags": " \n\nPool\n\nSpa\n\nFree Wi-Fi\n\nAir-conditioned",
  "Telephone": "",
  "Website": ""
}
```

## 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`.

```json
{
  "templateName": "google-maps-scraper-listing-page-by-url",
  "taskName": "Google Maps Listings Scraper (by URLs)",
  "parameters": "{\"target_URLs\":[\"https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"target_URLs\":[\"https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "google-maps-scraper-listing-page-by-url",
        "taskName": "Google Maps Listings Scraper (by URLs)",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "google-maps-scraper-listing-page-by-url",
  "taskName": "Google Maps Listings Scraper (by URLs)",
  "parameters": "{\"target_URLs\":[\"https://www.google.com/maps/search/resorts+cerca+de+Miami,+Florida,+EE.+UU./@25.7664504,-80.2517712,13z/data=!3m1!4b1?entry=ttu\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `google-maps-scraper-listing-page-by-url`, 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-scraper-listing-page-by-url.json)
- [Manifest](https://www.octoparse.com/templates/google-maps-scraper-listing-page-by-url-manifest.json)
