# Google Maps Listing and Details Page Scraper (Cloud)

Scrape place listings and details (title, address, geo info, rating, etc.) from Google Maps using keywords or specific URLs.

- Template page: [https://www.octoparse.com/template/google-maps-listing-and-details-page-scraper](https://www.octoparse.com/template/google-maps-listing-and-details-page-scraper)
- Categories: Maps
- Status: `PUBLISHED`
- Run mode: `CLOUD`

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

## Output

The current workflow extracts 3 fields, including `Textbox_value`, `FollowField`, `Title`.

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

## Input

### Language

Required. Select the search result language Constraints: minLength=1; maxLength=5000. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Select Site

Required. Select a region to search Constraints: minItems=1; maxItems=99; items.minLength=1; items.maxLength=5000; uniqueItems=true. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Keywords or URLs (up to 10,000)

Required. Keywords or URLs (up to 10,000) Constraints: minItems=1; maxItems=100000; items.minLength=1; items.maxLength=5000.

## How to Use

# Google Maps Listing and Details Page Scraper (Cloud) – Usage Guide

This template collects workflow-stage values from Google Maps listing and detail navigation, including the submitted text value, a follow-up payload, and a title used by the linked extraction stage.

**Pricing:** Free of charge. Octoparse plan or resource limits may still apply.

## Output Fields

- `Textbox_value`
- `FollowField`
- `Title`

## Use Cases

- Prepare Google Maps search inputs for a linked detail-page extraction workflow.
- Preserve the submitted value alongside each generated follow-up payload.
- Associate generated detail work with the corresponding listing title.
- Split listing discovery and detail extraction into structured processing stages.

## Input

Complete the following fields:

- **Language** (Required) — Select the search result language. Options: English, 日本語, Español (España), Français (France), Deutsch, Italiano, 한국어, 繁體中文, Nederlands, Dansk.

- **Select Site** (Required) — Select a region to search. Up to 99 entries per run.

- **Keywords or URLs** (Required) — Keywords or URLs. Up to 100,000 entries per run.

## How to Use

1. Open the template and click **Try it!**.
2. Complete **Select Site**, **Keywords or URLs**, and **Language** using the formats and limits above.
3. Run it in the Octoparse cloud and start the task.
4. Review fields such as `Title`, `Textbox_value`, and `FollowField`, then export the rows in the format you need.

## Tips

- Start with a small, representative **Select Site** before scaling the task.
- Use `Title` and `Textbox_value` when checking duplicates or comparing repeated exports.

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

- [Superpages Details Page Scraper (Cloud)](https://www.octoparse.com/template/superpages-listing-scraper)
- [Google Maps Listing Scraper (Spanish)](https://www.octoparse.com/template/google-maps-scraper-tiendas-detalles-palabrasclave)
- [Google Maps Store Listing Scraper (Japan)](https://www.octoparse.com/template/google-maps-store-listing-scraper)
- [Google Maps Listing Scraper (Germany)](https://www.octoparse.com/template/google-maps-geschaefte-listing-scraper)
- [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)

## Input Schema

```json
{
  "title": "Google Maps Listing and Details Page Scraper (Cloud) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "language": {
      "title": "Language",
      "description": "Select the search result language",
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "oneOf": [
        {
          "title": "English",
          "const": "English"
        },
        {
          "title": "日本語",
          "const": "日本語"
        },
        {
          "title": "Español (España)",
          "const": "Español (España)"
        },
        {
          "title": "Français (France)",
          "const": "Français (France)"
        },
        {
          "title": "Deutsch",
          "const": "Deutsch"
        },
        {
          "title": "Italiano",
          "const": "Italiano"
        },
        {
          "title": "한국어",
          "const": "한국어"
        },
        {
          "title": "繁體中文",
          "const": "繁體中文"
        },
        {
          "title": "Nederlands",
          "const": "Nederlands"
        },
        {
          "title": "Dansk",
          "const": "Dansk"
        }
      ],
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "select_Site": {
      "title": "Select Site",
      "description": "Select a region to search",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000,
        "oneOf": [
          {
            "title": "the United States",
            "const": "https://www.google.com/maps/@37.0625,-95.677068,4z?hl=en&entry=ttu"
          },
          {
            "title": "the United Kingdom",
            "const": "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
          },
          {
            "title": "Canada",
            "const": "https://www.google.com/maps/@49.891235,-97.15369,4z?hl=en&entry=ttu"
          },
          {
            "title": "Australia",
            "const": "https://www.google.com/maps/@-25.335448,135.745076,4z?hl=en&entry=ttu"
          },
          {
            "title": "日本",
            "const": "https://www.google.com/maps/@36.5626,136.362305,5z?hl=ja&entry=ttu"
          },
          {
            "title": "España",
            "const": "https://www.google.com/maps/@40.396764,-3.713379,6z?hl=es&entry=ttu"
          },
          {
            "title": "France",
            "const": "https://www.google.com/maps/@46.75984,1.738281,6z?hl=fr&entry=ttu"
          },
          {
            "title": "Schweiz",
            "const": "https://www.google.com/maps/@46.362093,9.036255,7z?hl=de&entry=ttu"
          },
          {
            "title": "Österreich",
            "const": "https://www.google.com/maps/@47.635784,13.590088,7z?hl=de&entry=ttu"
          },
          {
            "title": "Deutschland",
            "const": "https://www.google.com/maps/@51.151786,10.415039,6z?hl=de&entry=ttu"
          },
          {
            "title": "Italia",
            "const": "https://www.google.com/maps/@41.442726,12.392578,6z?hl=it&entry=ttu"
          },
          {
            "title": "대한민국",
            "const": "https://www.google.com/maps/@37.8981629,122.3696269,6z?hl=ko&entry=ttu"
          },
          {
            "title": "中國香港",
            "const": "https://www.google.com/maps/@22.327244,114.1048769,13z?hl=zh_TW&entry=ttu"
          },
          {
            "title": "中國台灣",
            "const": "https://www.google.com/maps/@36.5626,136.362305,5z?hl=zh_TW&entry=ttu"
          },
          {
            "title": "Nederland",
            "const": "https://www.google.com/maps/@52.2056109,3.957836,8z?hl=nl&entry=ttu"
          },
          {
            "title": "Danmark",
            "const": "https://www.google.com/maps/@52.2056109,3.957836,8z?hl=da&entry=ttu"
          }
        ]
      },
      "minItems": 1,
      "maxItems": 99,
      "uniqueItems": true,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "keywords_or_URLs": {
      "title": "Keywords or URLs (up to 10,000)",
      "description": "Keywords or URLs (up to 10,000)",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "language",
    "select_Site",
    "keywords_or_URLs"
  ],
  "allOf": [
    {
      "if": {
        "properties": {
          "language": {
            "const": "English"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "the United States",
                  "const": "https://www.google.com/maps/@37.0625,-95.677068,4z?hl=en&entry=ttu"
                },
                {
                  "title": "the United Kingdom",
                  "const": "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
                },
                {
                  "title": "Canada",
                  "const": "https://www.google.com/maps/@49.891235,-97.15369,4z?hl=en&entry=ttu"
                },
                {
                  "title": "Australia",
                  "const": "https://www.google.com/maps/@-25.335448,135.745076,4z?hl=en&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "日本語"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "日本",
                  "const": "https://www.google.com/maps/@36.5626,136.362305,5z?hl=ja&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Español (España)"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "España",
                  "const": "https://www.google.com/maps/@40.396764,-3.713379,6z?hl=es&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Français (France)"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "France",
                  "const": "https://www.google.com/maps/@46.75984,1.738281,6z?hl=fr&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Deutsch"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Schweiz",
                  "const": "https://www.google.com/maps/@46.362093,9.036255,7z?hl=de&entry=ttu"
                },
                {
                  "title": "Österreich",
                  "const": "https://www.google.com/maps/@47.635784,13.590088,7z?hl=de&entry=ttu"
                },
                {
                  "title": "Deutschland",
                  "const": "https://www.google.com/maps/@51.151786,10.415039,6z?hl=de&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Italiano"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Italia",
                  "const": "https://www.google.com/maps/@41.442726,12.392578,6z?hl=it&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "한국어"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "대한민국",
                  "const": "https://www.google.com/maps/@37.8981629,122.3696269,6z?hl=ko&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "繁體中文"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "中國香港",
                  "const": "https://www.google.com/maps/@22.327244,114.1048769,13z?hl=zh_TW&entry=ttu"
                },
                {
                  "title": "中國台灣",
                  "const": "https://www.google.com/maps/@36.5626,136.362305,5z?hl=zh_TW&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Nederlands"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Nederland",
                  "const": "https://www.google.com/maps/@52.2056109,3.957836,8z?hl=nl&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "language": {
            "const": "Dansk"
          }
        },
        "required": [
          "language"
        ]
      },
      "then": {
        "properties": {
          "select_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Danmark",
                  "const": "https://www.google.com/maps/@52.2056109,3.957836,8z?hl=da&entry=ttu"
                }
              ]
            }
          }
        }
      }
    }
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Textbox_value": {
      "type": "string",
      "description": ""
    },
    "FollowField": {
      "type": "string",
      "description": ""
    },
    "Title": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Google Maps Listing and Details Page Scraper (Cloud) 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-listing-and-details-page-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-listing-and-details-page-scraper.json)
- [Manifest](https://www.octoparse.com/templates/google-maps-listing-and-details-page-scraper-manifest.json)