# Google Maps Scraper (`api-ninja/google-maps-scraper`) Actor

Extract comprehensive business data from Google Maps, including ratings, emails, social media profiles, photos, and operational details. Perfect for market research and lead generation.

- **URL**: https://apify.com/api-ninja/google-maps-scraper.md
- **Developed by:** [API ninja](https://apify.com/api-ninja) (community)
- **Categories:** Lead generation, Travel
- **Stats:** 480 total users, 120 monthly users, 100.0% runs succeeded, 22 bookmarks
- **User rating**: 4.92 out of 5 stars

## Pricing

from $1.20 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

**Google Maps Scraper** is a powerful Apify Actor designed to extract **Google Maps business and location data** at scale. It overcomes the standard Google Places API limits (20/60 results) by utilizing a smart, grid-based **quadtree search** to discover thousands of places in any given area.

📍 **Search by location & query** (e.g., 'dentists in Berlin')
🔍 **Deep grid search** to bypass 120‑result limit
🧾 **Export to JSON, CSV, Excel, HTML**

**Who is this for?**  
Perfect for **marketing professionals, researchers, and developers** who need large-scale local business data for lead generation or market analysis, without needing to write code.

💡 **Need Reviews?**  
This Actor focuses on discovering places and their details. To **parse detailed reviews** (text, author, dates, stars) for these places, use our companion tool:  
👉 **[Google Maps Reviews Scraper](https://apify.com/api-ninja/google-maps-reviews-scraper)**

---

### Table of contents

- [What does this Google Maps scraper do?](#what-does-this-google-maps-scraper-do)
- [What data can you extract from Google Maps?](#what-data-can-you-extract-from-google-maps)
- [How to scrape Reviews](#how-to-scrape-reviews)
- [Use cases: Google Maps data for leads & local SEO](#use-cases-google-maps-data-for-leads--local-seo)
- [How to scrape Google Maps business data](#how-to-scrape-google-maps-business-data)
- [Tips: performance & accuracy](#tips-performance--accuracy)
- [Limitations & Notes](#limitations--notes)
- [Is it legal to scrape Google Maps?](#is-it-legal-to-scrape-google-maps)
- [Input](#input)
- [Output](#output)
- [Integrations and API](#integrations-and-api)
- [Pricing](#pricing)
- [FAQ](#faq)
- [Support](#support)
- [License](#license)
- [Acknowledgments](#acknowledgments)

---

### What does this Google Maps scraper do?

Google Maps Scraper extracts structured data from **Google Maps** based on your **location** and optional **search query**. It supports both:

1.  **Text Search**: Find specific businesses (e.g., "coffee shops in Berlin", "Tesla chargers").
2.  **Nearby Search**: Discover all places in a specific area/neighborhood.

**Key Feature: Deep Search**  
Standard Google Maps searches often limit results to the top ~120 places. This Actor subdivides the search area into smaller "tiles" (quadtree), recursively querying each one to uncover **all available places** in the region, regardless of the display limits.[[GMaps grids & zoom](https://blog.apify.com/google-places-api-limits/#how-google-maps-scraper-gets-results)]

> **Note on coverage:**  
> Because the Actor relies on Google’s viewport tiles, results may sometimes extend slightly outside the exact requested bounds or vary based on Google's data density. This is normal behavior for "search by area".

---

### What data can you extract from Google Maps?

You can extract the following fields for each place (availability depends on the specific business):

| Category | Data points | Example field in output |
| :--- | :--- | :--- |
| **Basic info** | Name, place types, Place ID | `displayName.text`, `types`, `id` |
| **Location** | Address, city, country, coordinates | `formattedAddress`, `location.latitude` |
| **Contact** | Phone, website, Google Maps URL | `nationalPhoneNumber`, `websiteUri`, `googleMapsUri` |
| **Contact enrichment (optional)** | Emails and social/contact links from the business web presence | `emails_and_contacts` |
| **Performance** | Rating, review count, price level | `rating`, `userRatingCount`, `priceLevel` |
| **Metadata** | Language code, business status | `displayName.languageCode`, `businessStatus` |

You can download the dataset in **JSON, CSV, Excel, or HTML table formats** from the Storage tab.

---

### How to scrape Reviews

This Actor is optimized for **Place Discovery**. If your goal is to analyze customer sentiment, extract review text, or monitor feedback, you should use the extracted Place IDs or URLs from this run as input for our specialized reviews scraper.

**Workflow:**
1.  **Run Google Maps Scraper** (this Actor) to find businesses.
2.  **Copy the `googleMapsUri` or `id`** from the results.
3.  **Run the [Google Maps Reviews Scraper](https://apify.com/api-ninja/google-maps-reviews-scraper)** using those IDs/URLs.

---

### Use cases: Google Maps data for leads & local SEO

- **Generate Leads**: Build lists of local businesses with phone numbers and websites (e.g., "Plumbers in New York").
- **Market Research**: Analyze competitor density and ratings across different neighborhoods.
- **Site Selection**: Evaluate potential locations for new stores based on existing amenities.
- **Data Enrichment**: Verify or update your existing business database with fresh Google Maps data.

#### Why run this scraper on Apify?
Running this Actor on the Apify platform gives you advantages over local scripts:
- **Scheduling**: Schedule recurring scrapes (daily/weekly) to keep your local business data fresh.
- **Proxies**: Uses built‑in proxy rotation for reliable scraping without getting blocked.
- **Integrations**: Connect results directly to CRMs, Google Sheets, or Slack via Zapier/Make.
- **Monitoring**: Track run history, logs, and errors in a single dashboard.

---

### How to scrape Google Maps business data

#### How to scrape Google Maps data without coding
1.  **Open the Actor** in the Apify Console.
2.  **Go to the Input tab**.
3.  **Enter a Location**: e.g., `London, UK` or `123 Main St, San Francisco`. The Actor will automatically geocode this.
4.  **Choose a Mode**:
    *   **Text Search**: Enter a query like `Italian restaurants` or `Dentists`.
    *   **Nearby Search**: Leave the query empty to find *everything* in that location.
5.  **(Optional) Set Filters**: Filter by Place Type (e.g., `gym`, `museum`), Price Level, or Min Rating.
6.  **(Optional) Enable `includeContacts`**: Adds deeper contact enrichment (`emails_and_contacts`) per place. This takes longer and has additional metered billing.
7.  **Start the Run**: Click **Start**.
8.  **Download Results**: Once finished, go to the **Dataset** tab to export your data.

---

### Tips: performance & accuracy

To get the most out of your runs and optimize Compute Units (CUs):

*   **Use smaller locations**: For exhaustive scrapes, targeting specific districts or ZIP codes (e.g., "Manhattan, NY" instead of "New York") often yields better coverage and performance than broad city searches.
*   **Validate first**: Start with a small `maxResultCount` (e.g., 50) to verify your search queries and filters are returning the expected data before launching a large run.
*   **Deep search control**: Uncheck `scrapeAllPlaces` if you only need the top-ranking results. Enable it only when you need comprehensive coverage of an entire area.
*   **Contact enrichment cost/performance**: Enable `includeContacts` only when needed. It performs extra detail lookups, increases runtime, and adds per-result charges.

---

### Limitations & Notes

*   **Density Limits**: In extremely dense urban areas (e.g., Manhattan), Google might not return every single small business in one pass. For 100% coverage, split your search into smaller sub-districts or use ZIP codes.
*   **Viewport Overlap**: Results may occasionally include places slightly outside your requested bounds if they fall within the overlapping map tiles used for searching.
*   **Language Bias**: The results' language and formatting can be influenced by the `languageCode` and `regionCode` input parameters.

---

### Is it legal to scrape Google Maps?

This Actor extracts **publicly available business information**. However, you must comply with:
- **Regulations**: GDPR, CCPA, and other data protection laws (especially regarding personal data in reviews, though this Actor primarily targets business info).
- **Terms of Service**: Google's terms regarding crawling and data use. See [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms).

---

### Input

The input configuration allows you to define the search area, query, and filters. Below are the primary fields:

| Field | Type | Description |
| :--- | :--- | :--- |
| `location` | string | **Required**. City, address, or area to search (e.g., "Paris", "NYC"). |
| `textQuery` | string | Optional. Specific business type or keyword (e.g., "pizza"). |
| `maxResultCount` | number | Approximate target number of places to return. |
| `scrapeAllPlaces` | boolean | Enable deep grid search for full coverage (slower, more results). |
| `includeContacts` | boolean | If `true`, enriches places with `emails_and_contacts` (emails/social/contact links when available). Slower and billed separately. |
| `languageCode` | string | Language for results (e.g., `en`, `de`, `es`). |

> **Note**: See full configuration options including Place Types, Price Levels, and EV Charging filters in the **Input** tab of the Actor.

---

### Output

Results are stored in the default Apify dataset. You can download the dataset in **JSON, CSV, Excel, or HTML table formats** from the **Storage** or **Dataset** tab. The full output schema is also available for review in the Dataset tab.

If `includeContacts` is enabled, records may include an additional `emails_and_contacts` object. This field can be `null` when no contacts are found.

**Example JSON Object:**

```json
{
  "id": "ChIJrTLr-GyuEmsRBfyf1GD_kQk",
  "types": ["park", "tourist_attraction"],
  "formattedAddress": "New York, NY 10024, USA",
  "location": {
    "latitude": 40.7829,
    "longitude": -73.9654
  },
  "rating": 4.8,
  "userRatingCount": 145234,
  "nationalPhoneNumber": "+1 212-310-6600",
  "websiteUri": "http://www.centralparknyc.org/",
  "emails_and_contacts": {
    "emails": ["hello@example.com"],
    "socials": ["https://www.instagram.com/example"]
  },
  "googleMapsUri": "https://maps.google.com/?cid=10924849423985355605",
  "displayName": {
    "text": "Central Park",
    "languageCode": "en"
  }
}
````

***

### Integrations and API

You can programmatically trigger this Actor using the [Apify API](https://docs.apify.com/api/v2) or [Apify Client for Python/JS](https://docs.apify.com/sdk).

**Python Example:**

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "location": "San Francisco, CA",
    "textQuery": "coffee shops",
    "maxResultCount": 100
}

run = client.actor("api-ninja/google-maps-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['displayName']['text']} - {item['rating']} stars")
```

***

### Pricing

This Actor is efficient, but costs depend on the volume of data and platform usage (Compute Units).

- **Free Plan**: You can test this Actor using your free monthly credits.
- **Paid Plans**: For large-scale extraction, a paid Apify plan is recommended.
- **`includeContacts` add-on**: When enabled, contact enrichment is billed as an extra metered event per processed place and increases runtime.

Check the [Apify Pricing Page](https://apify.com/pricing) for current rates.

***

### FAQ

**Q: Is this a Google Maps API alternative?**\
A: Yes, this actor provides an alternative way to access Google Maps data without the constraints of the official API's rigorous rate limits, specifically useful for bulk data collection.

**Q: Do I need proxies to scrape Google Maps?**\
A: No, you don't need to configure proxies manually. The Apify platform handles proxy rotation and management automatically to ensure reliable extraction.

**Q: Can I use this with no coding via the UI?**\
A: Absolutely. The Actor is designed to be used directly from the Apify Console with a user-friendly interface. No coding skills are required.

**Q: The Actor returned fewer results than I expected – what can I do?**\
A: Try enabling `scrapeAllPlaces` to force a deeper grid search, or break your location down into smaller areas (e.g., search by ZIP code instead of the whole city). Also, ensure `maxResultCount` is high enough.

**Q: My run is timing out or using too many CUs – how do I optimize?**\
A: Reduce the size of your search area or use more specific keywords. If you are scraping a huge area, consider splitting it into multiple runs.

**Q: Can I get email addresses?**\
A: Yes, if you enable `includeContacts`. The Actor performs an additional enrichment step and may return emails/social/contact links in `emails_and_contacts`. Availability is not guaranteed for every place.

***

### Support

If you encounter any issues or have feature requests:

- **Issues**: Please use the **Issues** tab on the Actor page to report bugs or request new features.
- **Email**: apify@dziura.online

***

### License

Apache License 2.0

# Actor input Schema

## `location` (type: `string`):

Location to search (e.g., 'LA, California', 'New York, NY', 'Paris, France'). Will be geocoded to coordinates.

## `textQuery` (type: `string`):

If provided, uses Text Search (e.g., 'best pizza'). If empty, uses Nearby Search to find all places in the area.

## `includeContacts` (type: `boolean`):

If enabled, extracts business phones, emails, and social media profiles. Takes longer to process and incurs additional billing charges. See pricing details for more information. **Note:** Not guaranteed all locations will return contact details. *Method: scrape emails and contacts from the business website (in case non-empty)*

## `maxResultCount` (type: `integer`):

Maximum number of places to return

## `scrapeAllPlaces` (type: `boolean`):

If enabled, all places from the location will be scraped. Maximum results will be ignored.

## `includedTypes` (type: `array`):

Filter by place types. When using **Search Query**, only the first type is used.

## `excludedTypes` (type: `array`):

Exclude specific place types (only works with if no **Search Query** is provided)

## `includedPrimaryTypes` (type: `array`):

Filter by primary place types (only works if no **Search Query** is provided)

## `excludedPrimaryTypes` (type: `array`):

Exclude primary place types (only works if no **Search Query** is provided)

## `minRating` (type: `string`):

Restricts results to only those whose average user rating is greater than or equal to this limit. Values must be between 0.0 and 5.0 (inclusive) in increments of 0.5. For example: 0, 0.5, 1.0, ... , 5.0 inclusive. Values are rounded up to the nearest 0.5. For example, a value of 0.6 eliminates all results with a rating less than 1.0.

## `priceLevels` (type: `array`):

Restrict the search to places that are marked at certain price levels. The default is to select all price levels.  Price levels can be expected for places of the following types:  Food and Drink, Services, Shopping. [Read types](https://developers.google.com/maps/documentation/places/web-service/search-text#place-type-filter)

## `connectorTypes` (type: `array`):

Filters by the type of EV charging connector available at a place. A place that does not support any of the connector types will be filtered out.

## `minimumChargingRateKw` (type: `integer`):

Filters places by minimum EV charging rate in kilowatts (kW). Any places with charging a rate less than the minimum charging rate are filtered out.

## `openNow` (type: `boolean`):

If true, return only those places that are open for business at the time the query is sent. If false, return all businesses regardless of open status. Places that don't specify opening hours in the Google Places database are returned if you set this parameter to false

## `strictTypeFiltering` (type: `boolean`):

Used with the includedType parameter. When set to true, only places that match the specified types specified by includedType are returned. When false, the default, the response can contain places that don't match the specified types.

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

Language for results (e.g., 'en', 'es', 'fr'). The language in which to return results.See the [list of supported languages](https://developers.google.com/maps/faq#languagesupport). Google often updates the supported languages, so this list may not be exhaustive.

## `regionCode` (type: `string`):

Country/region code (e.g., 'US', 'FR', 'JP'). The region code used to format the response, specified as a [two-character CLDR code](https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html) value. This parameter can also have a bias effect on the search results.

## Actor input object example

```json
{
  "location": "New York, NY",
  "textQuery": "Best pizza",
  "includeContacts": false,
  "maxResultCount": 40,
  "scrapeAllPlaces": false,
  "openNow": false,
  "strictTypeFiltering": false,
  "languageCode": "en",
  "regionCode": "US"
}
```

# Actor output Schema

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

No description

# 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 = {
    "location": "New York, NY",
    "textQuery": "Best pizza"
};

// Run the Actor and wait for it to finish
const run = await client.actor("api-ninja/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 = {
    "location": "New York, NY",
    "textQuery": "Best pizza",
}

# Run the Actor and wait for it to finish
run = client.actor("api-ninja/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 '{
  "location": "New York, NY",
  "textQuery": "Best pizza"
}' |
apify call api-ninja/google-maps-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Maps Scraper",
        "description": "Extract comprehensive business data from Google Maps, including ratings, emails, social media profiles, photos, and operational details. Perfect for market research and lead generation.",
        "version": "0.0",
        "x-build-id": "gLl9HQoSeigGvuIdJ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/api-ninja~google-maps-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-api-ninja-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/api-ninja~google-maps-scraper/runs": {
            "post": {
                "operationId": "runs-sync-api-ninja-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/api-ninja~google-maps-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-api-ninja-google-maps-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "location"
                ],
                "properties": {
                    "location": {
                        "title": "📍 Location",
                        "type": "string",
                        "description": "Location to search (e.g., 'LA, California', 'New York, NY', 'Paris, France'). Will be geocoded to coordinates."
                    },
                    "textQuery": {
                        "title": "🔍 Search Query (Optional)",
                        "type": "string",
                        "description": "If provided, uses Text Search (e.g., 'best pizza'). If empty, uses Nearby Search to find all places in the area."
                    },
                    "includeContacts": {
                        "title": "📩 Include Contact Details (Phones, Emails, Socials)",
                        "type": "boolean",
                        "description": "If enabled, extracts business phones, emails, and social media profiles. Takes longer to process and incurs additional billing charges. See pricing details for more information. **Note:** Not guaranteed all locations will return contact details. *Method: scrape emails and contacts from the business website (in case non-empty)*",
                        "default": false
                    },
                    "maxResultCount": {
                        "title": "Max Results",
                        "minimum": 40,
                        "type": "integer",
                        "description": "Maximum number of places to return",
                        "default": 40
                    },
                    "scrapeAllPlaces": {
                        "title": "Scrape All Places",
                        "type": "boolean",
                        "description": "If enabled, all places from the location will be scraped. Maximum results will be ignored.",
                        "default": false
                    },
                    "includedTypes": {
                        "title": "Included Place Types",
                        "type": "array",
                        "description": "Filter by place types. When using **Search Query**, only the first type is used.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "car_dealer",
                                "car_rental",
                                "car_repair",
                                "car_wash",
                                "electric_vehicle_charging_station",
                                "gas_station",
                                "parking",
                                "rest_stop",
                                "corporate_office",
                                "farm",
                                "ranch",
                                "art_gallery",
                                "art_studio",
                                "auditorium",
                                "cultural_landmark",
                                "historical_place",
                                "monument",
                                "museum",
                                "performing_arts_theater",
                                "sculpture",
                                "library",
                                "preschool",
                                "primary_school",
                                "school",
                                "secondary_school",
                                "university",
                                "adventure_sports_center",
                                "amphitheatre",
                                "amusement_center",
                                "amusement_park",
                                "aquarium",
                                "banquet_hall",
                                "barbecue_area",
                                "botanical_garden",
                                "bowling_alley",
                                "casino",
                                "childrens_camp",
                                "comedy_club",
                                "community_center",
                                "concert_hall",
                                "convention_center",
                                "cultural_center",
                                "cycling_park",
                                "dance_hall",
                                "dog_park",
                                "event_venue",
                                "ferris_wheel",
                                "garden",
                                "hiking_area",
                                "historical_landmark",
                                "internet_cafe",
                                "karaoke",
                                "marina",
                                "movie_rental",
                                "movie_theater",
                                "national_park",
                                "night_club",
                                "observation_deck",
                                "off_roading_area",
                                "opera_house",
                                "park",
                                "philharmonic_hall",
                                "picnic_ground",
                                "planetarium",
                                "plaza",
                                "roller_coaster",
                                "skateboard_park",
                                "state_park",
                                "tourist_attraction",
                                "video_arcade",
                                "visitor_center",
                                "water_park",
                                "wedding_venue",
                                "wildlife_park",
                                "wildlife_refuge",
                                "zoo",
                                "public_bath",
                                "public_bathroom",
                                "stable",
                                "accounting",
                                "atm",
                                "bank",
                                "acai_shop",
                                "afghani_restaurant",
                                "african_restaurant",
                                "american_restaurant",
                                "asian_restaurant",
                                "bagel_shop",
                                "bakery",
                                "bar",
                                "bar_and_grill",
                                "barbecue_restaurant",
                                "brazilian_restaurant",
                                "breakfast_restaurant",
                                "brunch_restaurant",
                                "buffet_restaurant",
                                "cafe",
                                "cafeteria",
                                "candy_store",
                                "cat_cafe",
                                "chinese_restaurant",
                                "chocolate_factory",
                                "chocolate_shop",
                                "coffee_shop",
                                "confectionery",
                                "deli",
                                "dessert_restaurant",
                                "dessert_shop",
                                "diner",
                                "dog_cafe",
                                "donut_shop",
                                "fast_food_restaurant",
                                "fine_dining_restaurant",
                                "food_court",
                                "french_restaurant",
                                "greek_restaurant",
                                "hamburger_restaurant",
                                "ice_cream_shop",
                                "indian_restaurant",
                                "indonesian_restaurant",
                                "italian_restaurant",
                                "japanese_restaurant",
                                "juice_shop",
                                "korean_restaurant",
                                "lebanese_restaurant",
                                "meal_delivery",
                                "meal_takeaway",
                                "mediterranean_restaurant",
                                "mexican_restaurant",
                                "middle_eastern_restaurant",
                                "pizza_restaurant",
                                "pub",
                                "ramen_restaurant",
                                "restaurant",
                                "sandwich_shop",
                                "seafood_restaurant",
                                "spanish_restaurant",
                                "steak_house",
                                "sushi_restaurant",
                                "tea_house",
                                "thai_restaurant",
                                "turkish_restaurant",
                                "vegan_restaurant",
                                "vegetarian_restaurant",
                                "vietnamese_restaurant",
                                "wine_bar",
                                "administrative_area_level_1",
                                "administrative_area_level_2",
                                "country",
                                "locality",
                                "postal_code",
                                "school_district",
                                "city_hall",
                                "courthouse",
                                "embassy",
                                "fire_station",
                                "government_office",
                                "local_government_office",
                                "neighborhood_police_station",
                                "police",
                                "post_office",
                                "chiropractor",
                                "dental_clinic",
                                "dentist",
                                "doctor",
                                "drugstore",
                                "hospital",
                                "massage",
                                "medical_lab",
                                "pharmacy",
                                "physiotherapist",
                                "sauna",
                                "skin_care_clinic",
                                "spa",
                                "tanning_studio",
                                "wellness_center",
                                "yoga_studio",
                                "apartment_building",
                                "apartment_complex",
                                "condominium_complex",
                                "housing_complex",
                                "bed_and_breakfast",
                                "budget_japanese_inn",
                                "campground",
                                "camping_cabin",
                                "cottage",
                                "extended_stay_hotel",
                                "farmstay",
                                "guest_house",
                                "hostel",
                                "hotel",
                                "inn",
                                "japanese_inn",
                                "lodging",
                                "mobile_home_park",
                                "motel",
                                "private_guest_room",
                                "resort_hotel",
                                "rv_park",
                                "beach",
                                "church",
                                "hindu_temple",
                                "mosque",
                                "synagogues",
                                "astrologer",
                                "barber_shop",
                                "beautician",
                                "beauty_salon",
                                "body_art_service",
                                "catering_service",
                                "cemetery",
                                "child_care_agency",
                                "consultant",
                                "courier_service",
                                "electrician",
                                "florist",
                                "food_delivery",
                                "foot_care",
                                "funeral_home",
                                "hair_care",
                                "hair_salon",
                                "insurance_agency",
                                "laundry",
                                "lawyer",
                                "locksmith",
                                "makeup_artist",
                                "moving_company",
                                "nail_salon",
                                "painter",
                                "plumber",
                                "psychic",
                                "real_estate_agency",
                                "roofing_contractor",
                                "storage",
                                "summer_camp_organizer",
                                "tailor",
                                "telecommunications_service_provider",
                                "tour_agency",
                                "tourist_information_center",
                                "travel_agency",
                                "veterinary_care",
                                "asian_grocery_store",
                                "auto_parts_store",
                                "bicycle_store",
                                "book_store",
                                "butcher_shop",
                                "cell_phone_store",
                                "clothing_store",
                                "convenience_store",
                                "department_store",
                                "discount_store",
                                "electronics_store",
                                "food_store",
                                "furniture_store",
                                "gift_shop",
                                "grocery_store",
                                "hardware_store",
                                "home_goods_store",
                                "home_improvement_store",
                                "jewelry_store",
                                "liquor_store",
                                "market",
                                "pet_store",
                                "shoe_store",
                                "shopping_mall",
                                "sporting_goods_store",
                                "store",
                                "supermarket",
                                "warehouse_store",
                                "wholesaler",
                                "arena",
                                "athletic_field",
                                "fishing_charter",
                                "fishing_pond",
                                "fitness_center",
                                "golf_course",
                                "gym",
                                "ice_skating_rink",
                                "playground",
                                "ski_resort",
                                "sports_activity_location",
                                "sports_club",
                                "sports_coaching",
                                "sports_complex",
                                "stadium",
                                "swimming_pool",
                                "airport",
                                "airstrip",
                                "bus_station",
                                "bus_stop",
                                "ferry_terminal",
                                "heliport",
                                "international_airport",
                                "light_rail_station",
                                "park_and_ride",
                                "subway_station",
                                "taxi_stand",
                                "train_station",
                                "transit_depot",
                                "transit_station",
                                "truck_stop",
                                "administrative_area_level_3",
                                "administrative_area_level_4",
                                "administrative_area_level_5",
                                "administrative_area_level_6",
                                "administrative_area_level_7",
                                "archipelago",
                                "colloquial_area",
                                "continent",
                                "establishment",
                                "finance",
                                "food",
                                "general_contractor",
                                "geocode",
                                "health",
                                "intersection",
                                "landmark",
                                "natural_feature",
                                "neighborhood",
                                "place_of_worship",
                                "plus_code",
                                "point_of_interest",
                                "political",
                                "postal_code_prefix",
                                "postal_code_suffix",
                                "postal_town",
                                "premise",
                                "route",
                                "street_address",
                                "sublocality",
                                "sublocality_level_1",
                                "sublocality_level_2",
                                "sublocality_level_3",
                                "sublocality_level_4",
                                "sublocality_level_5",
                                "subpremise",
                                "town_square"
                            ]
                        }
                    },
                    "excludedTypes": {
                        "title": "Excluded Place Types",
                        "type": "array",
                        "description": "Exclude specific place types (only works with if no **Search Query** is provided)",
                        "items": {
                            "type": "string",
                            "enum": [
                                "car_dealer",
                                "car_rental",
                                "car_repair",
                                "car_wash",
                                "electric_vehicle_charging_station",
                                "gas_station",
                                "parking",
                                "rest_stop",
                                "corporate_office",
                                "farm",
                                "ranch",
                                "art_gallery",
                                "art_studio",
                                "auditorium",
                                "cultural_landmark",
                                "historical_place",
                                "monument",
                                "museum",
                                "performing_arts_theater",
                                "sculpture",
                                "library",
                                "preschool",
                                "primary_school",
                                "school",
                                "secondary_school",
                                "university",
                                "adventure_sports_center",
                                "amphitheatre",
                                "amusement_center",
                                "amusement_park",
                                "aquarium",
                                "banquet_hall",
                                "barbecue_area",
                                "botanical_garden",
                                "bowling_alley",
                                "casino",
                                "childrens_camp",
                                "comedy_club",
                                "community_center",
                                "concert_hall",
                                "convention_center",
                                "cultural_center",
                                "cycling_park",
                                "dance_hall",
                                "dog_park",
                                "event_venue",
                                "ferris_wheel",
                                "garden",
                                "hiking_area",
                                "historical_landmark",
                                "internet_cafe",
                                "karaoke",
                                "marina",
                                "movie_rental",
                                "movie_theater",
                                "national_park",
                                "night_club",
                                "observation_deck",
                                "off_roading_area",
                                "opera_house",
                                "park",
                                "philharmonic_hall",
                                "picnic_ground",
                                "planetarium",
                                "plaza",
                                "roller_coaster",
                                "skateboard_park",
                                "state_park",
                                "tourist_attraction",
                                "video_arcade",
                                "visitor_center",
                                "water_park",
                                "wedding_venue",
                                "wildlife_park",
                                "wildlife_refuge",
                                "zoo",
                                "public_bath",
                                "public_bathroom",
                                "stable",
                                "accounting",
                                "atm",
                                "bank",
                                "acai_shop",
                                "afghani_restaurant",
                                "african_restaurant",
                                "american_restaurant",
                                "asian_restaurant",
                                "bagel_shop",
                                "bakery",
                                "bar",
                                "bar_and_grill",
                                "barbecue_restaurant",
                                "brazilian_restaurant",
                                "breakfast_restaurant",
                                "brunch_restaurant",
                                "buffet_restaurant",
                                "cafe",
                                "cafeteria",
                                "candy_store",
                                "cat_cafe",
                                "chinese_restaurant",
                                "chocolate_factory",
                                "chocolate_shop",
                                "coffee_shop",
                                "confectionery",
                                "deli",
                                "dessert_restaurant",
                                "dessert_shop",
                                "diner",
                                "dog_cafe",
                                "donut_shop",
                                "fast_food_restaurant",
                                "fine_dining_restaurant",
                                "food_court",
                                "french_restaurant",
                                "greek_restaurant",
                                "hamburger_restaurant",
                                "ice_cream_shop",
                                "indian_restaurant",
                                "indonesian_restaurant",
                                "italian_restaurant",
                                "japanese_restaurant",
                                "juice_shop",
                                "korean_restaurant",
                                "lebanese_restaurant",
                                "meal_delivery",
                                "meal_takeaway",
                                "mediterranean_restaurant",
                                "mexican_restaurant",
                                "middle_eastern_restaurant",
                                "pizza_restaurant",
                                "pub",
                                "ramen_restaurant",
                                "restaurant",
                                "sandwich_shop",
                                "seafood_restaurant",
                                "spanish_restaurant",
                                "steak_house",
                                "sushi_restaurant",
                                "tea_house",
                                "thai_restaurant",
                                "turkish_restaurant",
                                "vegan_restaurant",
                                "vegetarian_restaurant",
                                "vietnamese_restaurant",
                                "wine_bar",
                                "administrative_area_level_1",
                                "administrative_area_level_2",
                                "country",
                                "locality",
                                "postal_code",
                                "school_district",
                                "city_hall",
                                "courthouse",
                                "embassy",
                                "fire_station",
                                "government_office",
                                "local_government_office",
                                "neighborhood_police_station",
                                "police",
                                "post_office",
                                "chiropractor",
                                "dental_clinic",
                                "dentist",
                                "doctor",
                                "drugstore",
                                "hospital",
                                "massage",
                                "medical_lab",
                                "pharmacy",
                                "physiotherapist",
                                "sauna",
                                "skin_care_clinic",
                                "spa",
                                "tanning_studio",
                                "wellness_center",
                                "yoga_studio",
                                "apartment_building",
                                "apartment_complex",
                                "condominium_complex",
                                "housing_complex",
                                "bed_and_breakfast",
                                "budget_japanese_inn",
                                "campground",
                                "camping_cabin",
                                "cottage",
                                "extended_stay_hotel",
                                "farmstay",
                                "guest_house",
                                "hostel",
                                "hotel",
                                "inn",
                                "japanese_inn",
                                "lodging",
                                "mobile_home_park",
                                "motel",
                                "private_guest_room",
                                "resort_hotel",
                                "rv_park",
                                "beach",
                                "church",
                                "hindu_temple",
                                "mosque",
                                "synagogues",
                                "astrologer",
                                "barber_shop",
                                "beautician",
                                "beauty_salon",
                                "body_art_service",
                                "catering_service",
                                "cemetery",
                                "child_care_agency",
                                "consultant",
                                "courier_service",
                                "electrician",
                                "florist",
                                "food_delivery",
                                "foot_care",
                                "funeral_home",
                                "hair_care",
                                "hair_salon",
                                "insurance_agency",
                                "laundry",
                                "lawyer",
                                "locksmith",
                                "makeup_artist",
                                "moving_company",
                                "nail_salon",
                                "painter",
                                "plumber",
                                "psychic",
                                "real_estate_agency",
                                "roofing_contractor",
                                "storage",
                                "summer_camp_organizer",
                                "tailor",
                                "telecommunications_service_provider",
                                "tour_agency",
                                "tourist_information_center",
                                "travel_agency",
                                "veterinary_care",
                                "asian_grocery_store",
                                "auto_parts_store",
                                "bicycle_store",
                                "book_store",
                                "butcher_shop",
                                "cell_phone_store",
                                "clothing_store",
                                "convenience_store",
                                "department_store",
                                "discount_store",
                                "electronics_store",
                                "food_store",
                                "furniture_store",
                                "gift_shop",
                                "grocery_store",
                                "hardware_store",
                                "home_goods_store",
                                "home_improvement_store",
                                "jewelry_store",
                                "liquor_store",
                                "market",
                                "pet_store",
                                "shoe_store",
                                "shopping_mall",
                                "sporting_goods_store",
                                "store",
                                "supermarket",
                                "warehouse_store",
                                "wholesaler",
                                "arena",
                                "athletic_field",
                                "fishing_charter",
                                "fishing_pond",
                                "fitness_center",
                                "golf_course",
                                "gym",
                                "ice_skating_rink",
                                "playground",
                                "ski_resort",
                                "sports_activity_location",
                                "sports_club",
                                "sports_coaching",
                                "sports_complex",
                                "stadium",
                                "swimming_pool",
                                "airport",
                                "airstrip",
                                "bus_station",
                                "bus_stop",
                                "ferry_terminal",
                                "heliport",
                                "international_airport",
                                "light_rail_station",
                                "park_and_ride",
                                "subway_station",
                                "taxi_stand",
                                "train_station",
                                "transit_depot",
                                "transit_station",
                                "truck_stop",
                                "administrative_area_level_3",
                                "administrative_area_level_4",
                                "administrative_area_level_5",
                                "administrative_area_level_6",
                                "administrative_area_level_7",
                                "archipelago",
                                "colloquial_area",
                                "continent",
                                "establishment",
                                "finance",
                                "food",
                                "general_contractor",
                                "geocode",
                                "health",
                                "intersection",
                                "landmark",
                                "natural_feature",
                                "neighborhood",
                                "place_of_worship",
                                "plus_code",
                                "point_of_interest",
                                "political",
                                "postal_code_prefix",
                                "postal_code_suffix",
                                "postal_town",
                                "premise",
                                "route",
                                "street_address",
                                "sublocality",
                                "sublocality_level_1",
                                "sublocality_level_2",
                                "sublocality_level_3",
                                "sublocality_level_4",
                                "sublocality_level_5",
                                "subpremise",
                                "town_square"
                            ]
                        }
                    },
                    "includedPrimaryTypes": {
                        "title": "Included Primary Types",
                        "type": "array",
                        "description": "Filter by primary place types (only works if no **Search Query** is provided)",
                        "items": {
                            "type": "string",
                            "enum": [
                                "car_dealer",
                                "car_rental",
                                "car_repair",
                                "car_wash",
                                "electric_vehicle_charging_station",
                                "gas_station",
                                "parking",
                                "rest_stop",
                                "corporate_office",
                                "farm",
                                "ranch",
                                "art_gallery",
                                "art_studio",
                                "auditorium",
                                "cultural_landmark",
                                "historical_place",
                                "monument",
                                "museum",
                                "performing_arts_theater",
                                "sculpture",
                                "library",
                                "preschool",
                                "primary_school",
                                "school",
                                "secondary_school",
                                "university",
                                "adventure_sports_center",
                                "amphitheatre",
                                "amusement_center",
                                "amusement_park",
                                "aquarium",
                                "banquet_hall",
                                "barbecue_area",
                                "botanical_garden",
                                "bowling_alley",
                                "casino",
                                "childrens_camp",
                                "comedy_club",
                                "community_center",
                                "concert_hall",
                                "convention_center",
                                "cultural_center",
                                "cycling_park",
                                "dance_hall",
                                "dog_park",
                                "event_venue",
                                "ferris_wheel",
                                "garden",
                                "hiking_area",
                                "historical_landmark",
                                "internet_cafe",
                                "karaoke",
                                "marina",
                                "movie_rental",
                                "movie_theater",
                                "national_park",
                                "night_club",
                                "observation_deck",
                                "off_roading_area",
                                "opera_house",
                                "park",
                                "philharmonic_hall",
                                "picnic_ground",
                                "planetarium",
                                "plaza",
                                "roller_coaster",
                                "skateboard_park",
                                "state_park",
                                "tourist_attraction",
                                "video_arcade",
                                "visitor_center",
                                "water_park",
                                "wedding_venue",
                                "wildlife_park",
                                "wildlife_refuge",
                                "zoo",
                                "public_bath",
                                "public_bathroom",
                                "stable",
                                "accounting",
                                "atm",
                                "bank",
                                "acai_shop",
                                "afghani_restaurant",
                                "african_restaurant",
                                "american_restaurant",
                                "asian_restaurant",
                                "bagel_shop",
                                "bakery",
                                "bar",
                                "bar_and_grill",
                                "barbecue_restaurant",
                                "brazilian_restaurant",
                                "breakfast_restaurant",
                                "brunch_restaurant",
                                "buffet_restaurant",
                                "cafe",
                                "cafeteria",
                                "candy_store",
                                "cat_cafe",
                                "chinese_restaurant",
                                "chocolate_factory",
                                "chocolate_shop",
                                "coffee_shop",
                                "confectionery",
                                "deli",
                                "dessert_restaurant",
                                "dessert_shop",
                                "diner",
                                "dog_cafe",
                                "donut_shop",
                                "fast_food_restaurant",
                                "fine_dining_restaurant",
                                "food_court",
                                "french_restaurant",
                                "greek_restaurant",
                                "hamburger_restaurant",
                                "ice_cream_shop",
                                "indian_restaurant",
                                "indonesian_restaurant",
                                "italian_restaurant",
                                "japanese_restaurant",
                                "juice_shop",
                                "korean_restaurant",
                                "lebanese_restaurant",
                                "meal_delivery",
                                "meal_takeaway",
                                "mediterranean_restaurant",
                                "mexican_restaurant",
                                "middle_eastern_restaurant",
                                "pizza_restaurant",
                                "pub",
                                "ramen_restaurant",
                                "restaurant",
                                "sandwich_shop",
                                "seafood_restaurant",
                                "spanish_restaurant",
                                "steak_house",
                                "sushi_restaurant",
                                "tea_house",
                                "thai_restaurant",
                                "turkish_restaurant",
                                "vegan_restaurant",
                                "vegetarian_restaurant",
                                "vietnamese_restaurant",
                                "wine_bar",
                                "administrative_area_level_1",
                                "administrative_area_level_2",
                                "country",
                                "locality",
                                "postal_code",
                                "school_district",
                                "city_hall",
                                "courthouse",
                                "embassy",
                                "fire_station",
                                "government_office",
                                "local_government_office",
                                "neighborhood_police_station",
                                "police",
                                "post_office",
                                "chiropractor",
                                "dental_clinic",
                                "dentist",
                                "doctor",
                                "drugstore",
                                "hospital",
                                "massage",
                                "medical_lab",
                                "pharmacy",
                                "physiotherapist",
                                "sauna",
                                "skin_care_clinic",
                                "spa",
                                "tanning_studio",
                                "wellness_center",
                                "yoga_studio",
                                "apartment_building",
                                "apartment_complex",
                                "condominium_complex",
                                "housing_complex",
                                "bed_and_breakfast",
                                "budget_japanese_inn",
                                "campground",
                                "camping_cabin",
                                "cottage",
                                "extended_stay_hotel",
                                "farmstay",
                                "guest_house",
                                "hostel",
                                "hotel",
                                "inn",
                                "japanese_inn",
                                "lodging",
                                "mobile_home_park",
                                "motel",
                                "private_guest_room",
                                "resort_hotel",
                                "rv_park",
                                "beach",
                                "church",
                                "hindu_temple",
                                "mosque",
                                "synagogues",
                                "astrologer",
                                "barber_shop",
                                "beautician",
                                "beauty_salon",
                                "body_art_service",
                                "catering_service",
                                "cemetery",
                                "child_care_agency",
                                "consultant",
                                "courier_service",
                                "electrician",
                                "florist",
                                "food_delivery",
                                "foot_care",
                                "funeral_home",
                                "hair_care",
                                "hair_salon",
                                "insurance_agency",
                                "laundry",
                                "lawyer",
                                "locksmith",
                                "makeup_artist",
                                "moving_company",
                                "nail_salon",
                                "painter",
                                "plumber",
                                "psychic",
                                "real_estate_agency",
                                "roofing_contractor",
                                "storage",
                                "summer_camp_organizer",
                                "tailor",
                                "telecommunications_service_provider",
                                "tour_agency",
                                "tourist_information_center",
                                "travel_agency",
                                "veterinary_care",
                                "asian_grocery_store",
                                "auto_parts_store",
                                "bicycle_store",
                                "book_store",
                                "butcher_shop",
                                "cell_phone_store",
                                "clothing_store",
                                "convenience_store",
                                "department_store",
                                "discount_store",
                                "electronics_store",
                                "food_store",
                                "furniture_store",
                                "gift_shop",
                                "grocery_store",
                                "hardware_store",
                                "home_goods_store",
                                "home_improvement_store",
                                "jewelry_store",
                                "liquor_store",
                                "market",
                                "pet_store",
                                "shoe_store",
                                "shopping_mall",
                                "sporting_goods_store",
                                "store",
                                "supermarket",
                                "warehouse_store",
                                "wholesaler",
                                "arena",
                                "athletic_field",
                                "fishing_charter",
                                "fishing_pond",
                                "fitness_center",
                                "golf_course",
                                "gym",
                                "ice_skating_rink",
                                "playground",
                                "ski_resort",
                                "sports_activity_location",
                                "sports_club",
                                "sports_coaching",
                                "sports_complex",
                                "stadium",
                                "swimming_pool",
                                "airport",
                                "airstrip",
                                "bus_station",
                                "bus_stop",
                                "ferry_terminal",
                                "heliport",
                                "international_airport",
                                "light_rail_station",
                                "park_and_ride",
                                "subway_station",
                                "taxi_stand",
                                "train_station",
                                "transit_depot",
                                "transit_station",
                                "truck_stop",
                                "administrative_area_level_3",
                                "administrative_area_level_4",
                                "administrative_area_level_5",
                                "administrative_area_level_6",
                                "administrative_area_level_7",
                                "archipelago",
                                "colloquial_area",
                                "continent",
                                "establishment",
                                "finance",
                                "food",
                                "general_contractor",
                                "geocode",
                                "health",
                                "intersection",
                                "landmark",
                                "natural_feature",
                                "neighborhood",
                                "place_of_worship",
                                "plus_code",
                                "point_of_interest",
                                "political",
                                "postal_code_prefix",
                                "postal_code_suffix",
                                "postal_town",
                                "premise",
                                "route",
                                "street_address",
                                "sublocality",
                                "sublocality_level_1",
                                "sublocality_level_2",
                                "sublocality_level_3",
                                "sublocality_level_4",
                                "sublocality_level_5",
                                "subpremise",
                                "town_square"
                            ]
                        }
                    },
                    "excludedPrimaryTypes": {
                        "title": "Excluded Primary Types",
                        "type": "array",
                        "description": "Exclude primary place types (only works if no **Search Query** is provided)",
                        "items": {
                            "type": "string",
                            "enum": [
                                "car_dealer",
                                "car_rental",
                                "car_repair",
                                "car_wash",
                                "electric_vehicle_charging_station",
                                "gas_station",
                                "parking",
                                "rest_stop",
                                "corporate_office",
                                "farm",
                                "ranch",
                                "art_gallery",
                                "art_studio",
                                "auditorium",
                                "cultural_landmark",
                                "historical_place",
                                "monument",
                                "museum",
                                "performing_arts_theater",
                                "sculpture",
                                "library",
                                "preschool",
                                "primary_school",
                                "school",
                                "secondary_school",
                                "university",
                                "adventure_sports_center",
                                "amphitheatre",
                                "amusement_center",
                                "amusement_park",
                                "aquarium",
                                "banquet_hall",
                                "barbecue_area",
                                "botanical_garden",
                                "bowling_alley",
                                "casino",
                                "childrens_camp",
                                "comedy_club",
                                "community_center",
                                "concert_hall",
                                "convention_center",
                                "cultural_center",
                                "cycling_park",
                                "dance_hall",
                                "dog_park",
                                "event_venue",
                                "ferris_wheel",
                                "garden",
                                "hiking_area",
                                "historical_landmark",
                                "internet_cafe",
                                "karaoke",
                                "marina",
                                "movie_rental",
                                "movie_theater",
                                "national_park",
                                "night_club",
                                "observation_deck",
                                "off_roading_area",
                                "opera_house",
                                "park",
                                "philharmonic_hall",
                                "picnic_ground",
                                "planetarium",
                                "plaza",
                                "roller_coaster",
                                "skateboard_park",
                                "state_park",
                                "tourist_attraction",
                                "video_arcade",
                                "visitor_center",
                                "water_park",
                                "wedding_venue",
                                "wildlife_park",
                                "wildlife_refuge",
                                "zoo",
                                "public_bath",
                                "public_bathroom",
                                "stable",
                                "accounting",
                                "atm",
                                "bank",
                                "acai_shop",
                                "afghani_restaurant",
                                "african_restaurant",
                                "american_restaurant",
                                "asian_restaurant",
                                "bagel_shop",
                                "bakery",
                                "bar",
                                "bar_and_grill",
                                "barbecue_restaurant",
                                "brazilian_restaurant",
                                "breakfast_restaurant",
                                "brunch_restaurant",
                                "buffet_restaurant",
                                "cafe",
                                "cafeteria",
                                "candy_store",
                                "cat_cafe",
                                "chinese_restaurant",
                                "chocolate_factory",
                                "chocolate_shop",
                                "coffee_shop",
                                "confectionery",
                                "deli",
                                "dessert_restaurant",
                                "dessert_shop",
                                "diner",
                                "dog_cafe",
                                "donut_shop",
                                "fast_food_restaurant",
                                "fine_dining_restaurant",
                                "food_court",
                                "french_restaurant",
                                "greek_restaurant",
                                "hamburger_restaurant",
                                "ice_cream_shop",
                                "indian_restaurant",
                                "indonesian_restaurant",
                                "italian_restaurant",
                                "japanese_restaurant",
                                "juice_shop",
                                "korean_restaurant",
                                "lebanese_restaurant",
                                "meal_delivery",
                                "meal_takeaway",
                                "mediterranean_restaurant",
                                "mexican_restaurant",
                                "middle_eastern_restaurant",
                                "pizza_restaurant",
                                "pub",
                                "ramen_restaurant",
                                "restaurant",
                                "sandwich_shop",
                                "seafood_restaurant",
                                "spanish_restaurant",
                                "steak_house",
                                "sushi_restaurant",
                                "tea_house",
                                "thai_restaurant",
                                "turkish_restaurant",
                                "vegan_restaurant",
                                "vegetarian_restaurant",
                                "vietnamese_restaurant",
                                "wine_bar",
                                "administrative_area_level_1",
                                "administrative_area_level_2",
                                "country",
                                "locality",
                                "postal_code",
                                "school_district",
                                "city_hall",
                                "courthouse",
                                "embassy",
                                "fire_station",
                                "government_office",
                                "local_government_office",
                                "neighborhood_police_station",
                                "police",
                                "post_office",
                                "chiropractor",
                                "dental_clinic",
                                "dentist",
                                "doctor",
                                "drugstore",
                                "hospital",
                                "massage",
                                "medical_lab",
                                "pharmacy",
                                "physiotherapist",
                                "sauna",
                                "skin_care_clinic",
                                "spa",
                                "tanning_studio",
                                "wellness_center",
                                "yoga_studio",
                                "apartment_building",
                                "apartment_complex",
                                "condominium_complex",
                                "housing_complex",
                                "bed_and_breakfast",
                                "budget_japanese_inn",
                                "campground",
                                "camping_cabin",
                                "cottage",
                                "extended_stay_hotel",
                                "farmstay",
                                "guest_house",
                                "hostel",
                                "hotel",
                                "inn",
                                "japanese_inn",
                                "lodging",
                                "mobile_home_park",
                                "motel",
                                "private_guest_room",
                                "resort_hotel",
                                "rv_park",
                                "beach",
                                "church",
                                "hindu_temple",
                                "mosque",
                                "synagogues",
                                "astrologer",
                                "barber_shop",
                                "beautician",
                                "beauty_salon",
                                "body_art_service",
                                "catering_service",
                                "cemetery",
                                "child_care_agency",
                                "consultant",
                                "courier_service",
                                "electrician",
                                "florist",
                                "food_delivery",
                                "foot_care",
                                "funeral_home",
                                "hair_care",
                                "hair_salon",
                                "insurance_agency",
                                "laundry",
                                "lawyer",
                                "locksmith",
                                "makeup_artist",
                                "moving_company",
                                "nail_salon",
                                "painter",
                                "plumber",
                                "psychic",
                                "real_estate_agency",
                                "roofing_contractor",
                                "storage",
                                "summer_camp_organizer",
                                "tailor",
                                "telecommunications_service_provider",
                                "tour_agency",
                                "tourist_information_center",
                                "travel_agency",
                                "veterinary_care",
                                "asian_grocery_store",
                                "auto_parts_store",
                                "bicycle_store",
                                "book_store",
                                "butcher_shop",
                                "cell_phone_store",
                                "clothing_store",
                                "convenience_store",
                                "department_store",
                                "discount_store",
                                "electronics_store",
                                "food_store",
                                "furniture_store",
                                "gift_shop",
                                "grocery_store",
                                "hardware_store",
                                "home_goods_store",
                                "home_improvement_store",
                                "jewelry_store",
                                "liquor_store",
                                "market",
                                "pet_store",
                                "shoe_store",
                                "shopping_mall",
                                "sporting_goods_store",
                                "store",
                                "supermarket",
                                "warehouse_store",
                                "wholesaler",
                                "arena",
                                "athletic_field",
                                "fishing_charter",
                                "fishing_pond",
                                "fitness_center",
                                "golf_course",
                                "gym",
                                "ice_skating_rink",
                                "playground",
                                "ski_resort",
                                "sports_activity_location",
                                "sports_club",
                                "sports_coaching",
                                "sports_complex",
                                "stadium",
                                "swimming_pool",
                                "airport",
                                "airstrip",
                                "bus_station",
                                "bus_stop",
                                "ferry_terminal",
                                "heliport",
                                "international_airport",
                                "light_rail_station",
                                "park_and_ride",
                                "subway_station",
                                "taxi_stand",
                                "train_station",
                                "transit_depot",
                                "transit_station",
                                "truck_stop",
                                "administrative_area_level_3",
                                "administrative_area_level_4",
                                "administrative_area_level_5",
                                "administrative_area_level_6",
                                "administrative_area_level_7",
                                "archipelago",
                                "colloquial_area",
                                "continent",
                                "establishment",
                                "finance",
                                "food",
                                "general_contractor",
                                "geocode",
                                "health",
                                "intersection",
                                "landmark",
                                "natural_feature",
                                "neighborhood",
                                "place_of_worship",
                                "plus_code",
                                "point_of_interest",
                                "political",
                                "postal_code_prefix",
                                "postal_code_suffix",
                                "postal_town",
                                "premise",
                                "route",
                                "street_address",
                                "sublocality",
                                "sublocality_level_1",
                                "sublocality_level_2",
                                "sublocality_level_3",
                                "sublocality_level_4",
                                "sublocality_level_5",
                                "subpremise",
                                "town_square"
                            ]
                        }
                    },
                    "minRating": {
                        "title": "Minimum Rating",
                        "enum": [
                            "0.5",
                            "1",
                            "1.5",
                            "2",
                            "2.5",
                            "3",
                            "3.5",
                            "4",
                            "4.5",
                            "5"
                        ],
                        "type": "string",
                        "description": "Restricts results to only those whose average user rating is greater than or equal to this limit. Values must be between 0.0 and 5.0 (inclusive) in increments of 0.5. For example: 0, 0.5, 1.0, ... , 5.0 inclusive. Values are rounded up to the nearest 0.5. For example, a value of 0.6 eliminates all results with a rating less than 1.0."
                    },
                    "priceLevels": {
                        "title": "Price Levels",
                        "type": "array",
                        "description": "Restrict the search to places that are marked at certain price levels. The default is to select all price levels.  Price levels can be expected for places of the following types:  Food and Drink, Services, Shopping. [Read types](https://developers.google.com/maps/documentation/places/web-service/search-text#place-type-filter)",
                        "items": {
                            "type": "string",
                            "enum": [
                                "PRICE_LEVEL_INEXPENSIVE",
                                "PRICE_LEVEL_MODERATE",
                                "PRICE_LEVEL_EXPENSIVE",
                                "PRICE_LEVEL_VERY_EXPENSIVE"
                            ],
                            "enumTitles": [
                                "💲",
                                "💲💲",
                                "💲💲💲",
                                "💲💲💲💲"
                            ]
                        }
                    },
                    "connectorTypes": {
                        "title": "🔋 EV Connector Types",
                        "type": "array",
                        "description": "Filters by the type of EV charging connector available at a place. A place that does not support any of the connector types will be filtered out.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "EV_CONNECTOR_TYPE_UNSPECIFIED",
                                "EV_CONNECTOR_TYPE_OTHER",
                                "EV_CONNECTOR_TYPE_J1772",
                                "EV_CONNECTOR_TYPE_TYPE_2",
                                "EV_CONNECTOR_TYPE_CHADEMO",
                                "EV_CONNECTOR_TYPE_CCS_COMBO_1",
                                "EV_CONNECTOR_TYPE_CCS_COMBO_2",
                                "EV_CONNECTOR_TYPE_TESLA",
                                "EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T",
                                "EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET",
                                "EV_CONNECTOR_TYPE_NACS"
                            ],
                            "enumTitles": [
                                "Unspecified connector",
                                "Other connector types",
                                "J1772 type 1 connector",
                                "IEC 62196 type 2 connector (MENNEKES)",
                                "CHAdeMO type connector",
                                "Combined Charging System (AC/DC) - SAE Type-1",
                                "Combined Charging System (AC/DC) - Type-2 Mennekes",
                                "Generic TESLA connector",
                                "GB/T standard (China)",
                                "Unspecified wall outlet",
                                "North American Charging System (NACS)"
                            ]
                        }
                    },
                    "minimumChargingRateKw": {
                        "title": "🔋 Minimum Charging Rate (kW)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Filters places by minimum EV charging rate in kilowatts (kW). Any places with charging a rate less than the minimum charging rate are filtered out."
                    },
                    "openNow": {
                        "title": "Open Now",
                        "type": "boolean",
                        "description": "If true, return only those places that are open for business at the time the query is sent. If false, return all businesses regardless of open status. Places that don't specify opening hours in the Google Places database are returned if you set this parameter to false",
                        "default": false
                    },
                    "strictTypeFiltering": {
                        "title": "Strict Type Filtering",
                        "type": "boolean",
                        "description": "Used with the includedType parameter. When set to true, only places that match the specified types specified by includedType are returned. When false, the default, the response can contain places that don't match the specified types.",
                        "default": false
                    },
                    "languageCode": {
                        "title": "Language Code",
                        "pattern": "^[a-z]{2}$",
                        "type": "string",
                        "description": "Language for results (e.g., 'en', 'es', 'fr'). The language in which to return results.See the [list of supported languages](https://developers.google.com/maps/faq#languagesupport). Google often updates the supported languages, so this list may not be exhaustive.",
                        "default": "en"
                    },
                    "regionCode": {
                        "title": "Region Code",
                        "pattern": "^[A-Z]{2}$",
                        "type": "string",
                        "description": "Country/region code (e.g., 'US', 'FR', 'JP'). The region code used to format the response, specified as a [two-character CLDR code](https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html) value. This parameter can also have a bias effect on the search results. ",
                        "default": "US"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
