# Google Maps Listings Scraper (by Keywords)

Extract Google Maps listing pages by keyword and location. Get business names, ratings, categories, addresses, and place URLs for leads, research, or further scraping—no coding required.

- Template page: [https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword)
- Categories: Maps
- 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 search-results pages.

## Output

The current workflow extracts 16 fields, including `Address`, `Category`, `Current_status`, `Detail_URL`, `Keyword`, `Latitude`, `Longitude`, `Name`, `Next_status`, `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 Google Maps Language, Confirm Target Site, Search Keywords (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

### Google Maps Language

Required. Select the Google Maps language version used for scraping. Constraints: minLength=1; maxLength=50000. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Confirm Target Site

Required. Confirm the website to be scraped. This ensures the task runs on the correct platform. Constraints: minItems=1; maxItems=10; items.minLength=1; items.maxLength=5000; uniqueItems=true. Callable values are the `const` keys in JSON `oneOf`, not the option titles.

### Search Keywords (up to 5,000)

Required. Enter one or multiple keywords. Supports up to 10,000 entries per run (one per line). Constraints: minItems=1; maxItems=100000; items.minLength=1; items.maxLength=50000.

## How to Use

## Google Maps Listing Page Scraper (by Keywords)

Extract all business listings from Google Maps search results using keywords and locations. No coding required.

### Captured Fields

- Business name
- Rating & review count
- Address
- Category
- Google Maps place details URL
- Latitude & longitude

### Important Limits

- Google Maps returns **~120–200 results per query** (keyword + location).
- To maximize coverage, break large locations into smaller sub-locations.

**Do:**  
- `restaurants in Manhattan, New York City`  
- `restaurants in Brooklyn, New York City`  
- `restaurants in Queens, New York City`  
- `restaurants in The Bronx, New York City`  
- `restaurants in Staten Island, New York City`

**Don't:**  
- `restaurants in New York City`

Use AI to generate sub-location combinations if needed.

### How to Use

1. **Start the template** – Click **Try It** or **Start**.
2. **Enter parameters:**

   | Parameter | Required | Description | Example |
   |---|---|---|---|
   | Google Maps Language | Yes | Language version of Google Maps | English |
   | Confirm Target Site | Yes | Must be `Google Maps` | Google Maps |
   | Search Keywords (up to 5,000) | Yes | One keyword per line, up to 10,000 entries total | `Starbucks near 95136`  
`Petrol stations in London, UK` |

3. **Run the scraper** – Click **Start**, then select a run mode.
4. **Handle CAPTCHA** – If one appears, pause the task, solve it manually in the built-in browser, then resume.
5. **Export data** – After completion, export as CSV, Excel, or JSON.

### Legal Note

- Scraping publicly visible, non-personal data from Google Maps is generally permitted.
- Comply with privacy laws (GDPR, CCPA) and Google's Terms of Service.
- Only scrape data that is publicly available (no login walls).

## 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 URLs)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-url)
- [Google Job Scraper (by Keywords)](https://www.octoparse.com/template/google-job-search)
- [Google Maps Reviews Scraper (by Reviewer)](https://www.octoparse.com/template/google-maps-reviews-scraper-by-user-page)
- [Google Maps Email Finder (by URLs)](https://www.octoparse.com/template/google-maps-email-finder-by-urls)
- [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 Keywords) input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "google_Maps_Language": {
      "title": "Google Maps Language",
      "description": "Select the Google Maps language version used for scraping.",
      "type": "string",
      "minLength": 1,
      "maxLength": 50000,
      "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"
        }
      ],
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "confirm_Target_Site": {
      "title": "Confirm Target Site",
      "description": "Confirm the website to be scraped. This ensures the task runs on the correct platform.",
      "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"
          }
        ]
      },
      "minItems": 1,
      "maxItems": 10,
      "uniqueItems": true,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "search_Keywords": {
      "title": "Search Keywords (up to 5,000)",
      "description": "Enter one or multiple keywords. Supports up to 10,000 entries per run (one per line).",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 50000
      },
      "minItems": 1,
      "maxItems": 100000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "google_Maps_Language",
    "confirm_Target_Site",
    "search_Keywords"
  ],
  "allOf": [
    {
      "if": {
        "properties": {
          "google_Maps_Language": {
            "const": "English"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_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": {
          "google_Maps_Language": {
            "const": "日本語"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "日本",
                  "const": "https://www.google.com/maps/@36.5626,136.362305,5z?hl=ja&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "google_Maps_Language": {
            "const": "Español (España)"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_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": {
          "google_Maps_Language": {
            "const": "Français (France)"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "France",
                  "const": "https://www.google.com/maps/@46.75984,1.738281,6z?hl=fr&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "google_Maps_Language": {
            "const": "Deutsch"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_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": {
          "google_Maps_Language": {
            "const": "Italiano"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Italia",
                  "const": "https://www.google.com/maps/@41.442726,12.392578,6z?hl=it&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "google_Maps_Language": {
            "const": "한국어"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "대한민국",
                  "const": "https://www.google.com/maps/@37.8981629,122.3696269,6z?hl=ko&entry=ttu"
                }
              ]
            }
          }
        }
      }
    },
    {
      "if": {
        "properties": {
          "google_Maps_Language": {
            "const": "繁體中文"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_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": {
          "google_Maps_Language": {
            "const": "Nederlands"
          }
        },
        "required": [
          "google_Maps_Language"
        ]
      },
      "then": {
        "properties": {
          "confirm_Target_Site": {
            "items": {
              "type": "string",
              "oneOf": [
                {
                  "title": "Nederland",
                  "const": "https://www.google.com/maps/@52.2056109,3.957836,8z?hl=nl&entry=ttu"
                }
              ]
            }
          }
        }
      }
    }
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "confirm_Target_Site": [
    "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
  ],
  "google_Maps_Language": "English",
  "search_Keywords": [
    "Barbers in Woodside, Berkshire",
    "Barbers in Woodspeen, Berkshire",
    "Barbers in Woolhampton, Berkshire",
    "Barbers in Woosehill, Berkshire",
    "Barbers in World's End, Berkshire"
  ]
}
```

Example 2

```json
{
  "confirm_Target_Site": [
    "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
  ],
  "google_Maps_Language": "English",
  "search_Keywords": [
    "Barbers in Eccleshall, Staffordshire",
    "Barbers in Ecton, Staffordshire",
    "Barbers in Edial, Staffordshire",
    "Barbers in Edingale, Staffordshire",
    "Barbers in Elford, Staffordshire"
  ]
}
```

Example 3

```json
{
  "confirm_Target_Site": [
    "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
  ],
  "google_Maps_Language": "English",
  "search_Keywords": [
    "Barbers in Bullsmoor, London",
    "Barbers in Burnt Oak, London",
    "Barbers in Bush Hill Park, London",
    "Barbers in Camberwell, London",
    "Barbers in Cambridge Heath, London"
  ]
}
```

Example 4

```json
{
  "confirm_Target_Site": [
    "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
  ],
  "google_Maps_Language": "English",
  "search_Keywords": [
    "Barbers in Hillis Corner, Isle of Wight",
    "Barbers in Hillway, Isle of Wight",
    "Barbers in Horringford, Isle of Wight",
    "Barbers in Hulverstone, Isle of Wight",
    "Barbers in Hunny Hill, Isle of Wight"
  ]
}
```

Example 5

```json
{
  "confirm_Target_Site": [
    "https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu"
  ],
  "google_Maps_Language": "English",
  "search_Keywords": [
    "Barbers in Hollingdon, Buckinghamshire",
    "Barbers in Holly Green, Buckinghamshire",
    "Barbers in Hollybush Hill, Buckinghamshire",
    "Barbers in Holmer Green, Buckinghamshire",
    "Barbers in Horn Hill, Buckinghamshire"
  ]
}
```


## 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": ""
    },
    "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 Keywords) 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": "45 High St",
  "Category": "Barber shop",
  "Current_status": "Open",
  "Detail_URL": "https://www.google.com/maps/place/Gould+Barbers+Ascot/data=!4m7!3m6!1s0x48767f001a9f7d01:0x2aa439c09ffb39ea!8m2!3d51.41083!4d-0.673546!16s%2Fg%2F11zwqm0yyr!19sChIJAX2fGgB_dkgR6jn7n8A5pCo?authuser=0&hl=en&g_ep=EgoyMDI2MTAyOC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Barbers in Woodside, Berkshire",
  "Latitude": "51.41083",
  "Longitude": "-0.673546",
  "Name": "Gould Barbers Ascot",
  "Next_status": " · Closes 6 PM",
  "Price_range": "",
  "Rating": "5.0",
  "Review_count": "9",
  "Scraped_at": "2026-10-31 12:17:26",
  "Tags": " \n\nBook online",
  "Telephone": "",
  "Website": ""
}
```

Example 2

```json
{
  "Address": "18 High St",
  "Category": "Hairdresser",
  "Current_status": "Open",
  "Detail_URL": "https://www.google.com/maps/place/Francesco+Hair+Salon+Eccleshall/data=!4m7!3m6!1s0x487a652e3fa8a631:0xe925fbaae330898c!8m2!3d52.8597329!4d-2.2529177!16s%2Fg%2F1vq9ltst!19sChIJMaaoPy5lekgRjIkw46r7Jek?authuser=0&hl=en&g_ep=EgoyMDI2MTAyOC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Barbers in Eccleshall, Staffordshire",
  "Latitude": "52.8597329",
  "Longitude": "-2.2529177",
  "Name": "Francesco Hair Salon Eccleshall",
  "Next_status": " · Closes 5 PM",
  "Price_range": "",
  "Rating": "4.9",
  "Review_count": "115",
  "Scraped_at": "2026-10-31 09:29:06",
  "Tags": " \n\nBook online",
  "Telephone": "",
  "Website": ""
}
```

Example 3

```json
{
  "Address": "101 Burnt Oak Broadway",
  "Category": "Barber shop",
  "Current_status": "Open",
  "Detail_URL": "https://www.google.com/maps/place/Max+Cutz/data=!4m7!3m6!1s0x487617c7ac3554e5:0xee6ef2f65351e46f!8m2!3d51.601561!4d-0.2688673!16s%2Fg%2F11v9zgj6jj!19sChIJ5VQ1rMcXdkgRb-RRU_bybu4?authuser=0&hl=en&g_ep=EgoyMDI2MTAyOC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Barbers in Burnt Oak, London",
  "Latitude": "51.601561",
  "Longitude": "-0.2688673",
  "Name": "Max Cutz",
  "Next_status": " · Closes 8 PM",
  "Price_range": "",
  "Rating": "4.8",
  "Review_count": "345",
  "Scraped_at": "2026-10-31 15:17:16",
  "Tags": " \n\nBook online",
  "Telephone": "",
  "Website": ""
}
```

Example 4

```json
{
  "Address": "3 Church Rd",
  "Category": "Barber shop",
  "Current_status": "Open",
  "Detail_URL": "https://www.google.com/maps/place/The+Craft+Cut/data=!4m7!3m6!1s0x48747b3a434dce9f:0xaa551f09f82d2f9f!8m2!3d50.7545651!4d-1.3207142!16s%2Fg%2F11wjqyb7_j!19sChIJn85NQzp7dEgRny8t-AkfVao?authuser=0&hl=en&g_ep=EgoyMDI2MTAyOC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Barbers in Hillis Corner, Isle of Wight",
  "Latitude": "50.7545651",
  "Longitude": "-1.3207142",
  "Name": "The Craft Cut",
  "Next_status": " · Closes 6 PM",
  "Price_range": "",
  "Rating": "5.0",
  "Review_count": "90",
  "Scraped_at": "2026-10-31 14:30:07",
  "Tags": " \n\nBook online",
  "Telephone": "",
  "Website": ""
}
```

Example 5

```json
{
  "Address": "10, Silk Mill Business Park, Brook St",
  "Category": "Barber shop",
  "Current_status": "Open",
  "Detail_URL": "https://www.google.com/maps/place/The+Spot+by+The+Barber+Envy/data=!4m7!3m6!1s0x48765ba9c7e4b193:0x9ef64f7d26b8c7a7!8m2!3d51.7981145!4d-0.6593178!16s%2Fg%2F11lh30tvph!19sChIJk7Hkx6lbdkgRp8e4Jn1P9p4?authuser=0&hl=en&g_ep=EgoyMDI2MTAyOC4wIJJjKgBIAVAD&rclk=1",
  "Keyword": "Barbers in Hollingdon, Buckinghamshire",
  "Latitude": "51.7981145",
  "Longitude": "-0.6593178",
  "Name": "The Spot by The Barber Envy",
  "Next_status": " · Closes 5 PM",
  "Price_range": "",
  "Rating": "5.0",
  "Review_count": "330",
  "Scraped_at": "2026-10-31 12:17:31",
  "Tags": " \n\nBook online",
  "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-keyword",
  "taskName": "Google Maps Listings Scraper (by Keywords)",
  "parameters": "{\"confirm_Target_Site\":[\"https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu\"],\"google_Maps_Language\":\"English\",\"search_Keywords\":[\"Barbers in Woodside, Berkshire\",\"Barbers in Woodspeen, Berkshire\",\"Barbers in Woolhampton, Berkshire\",\"Barbers in Woosehill, Berkshire\",\"Barbers in World's End, Berkshire\"]}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"confirm_Target_Site\":[\"https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu\"],\"google_Maps_Language\":\"English\",\"search_Keywords\":[\"Barbers in Woodside, Berkshire\",\"Barbers in Woodspeen, Berkshire\",\"Barbers in Woolhampton, Berkshire\",\"Barbers in Woosehill, Berkshire\",\"Barbers in World's End, Berkshire\"]}")

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-keyword",
        "taskName": "Google Maps Listings Scraper (by Keywords)",
        "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-keyword",
  "taskName": "Google Maps Listings Scraper (by Keywords)",
  "parameters": "{\"confirm_Target_Site\":[\"https://www.google.com/maps/@53.800651,-4.064941,6z?hl=en&entry=ttu\"],\"google_Maps_Language\":\"English\",\"search_Keywords\":[\"Barbers in Woodside, Berkshire\",\"Barbers in Woodspeen, Berkshire\",\"Barbers in Woolhampton, Berkshire\",\"Barbers in Woosehill, Berkshire\",\"Barbers in World's End, Berkshire\"]}"
}
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-keyword`, 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-keyword.json)
- [Manifest](https://www.octoparse.com/templates/google-maps-scraper-listing-page-by-keyword-manifest.json)
