Input schema (JSON)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"m": {
"type": "integer",
"maximum": 15028132,
"minimum": 1,
"description": "Alternative map scale parameter, 1-15028132 (an alternative to the zoom level)."
},
"q": {
"type": "string",
"description": "Search query, e.g. 'Coffee' or 'Restaurants'. Required for a search (type=search) unless place_id/data_cid is given."
},
"z": {
"type": "integer",
"maximum": 30,
"minimum": 3,
"description": "Map zoom level, 3-30 (higher = more zoomed in). Used with lat/lon or location; defaults to 14 when either is given without z or m."
},
"gl": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Country code for the search, e.g. 'us', 'uk', 'de'."
},
"hl": {
"type": "string",
"description": "Language code, e.g. 'en', 'es', 'fr', 'pt-br'."
},
"ll": {
"type": "string",
"description": "Map center as '@lat,lon,zoomz' (latitude, longitude, zoom), e.g. '@40.7455096,-74.0083012,14z'. Zoom recommended 3z-15z."
},
"lat": {
"type": "number",
"description": "Latitude of the map center (used with lon; alternative to ll)."
},
"lon": {
"type": "number",
"description": "Longitude of the map center (used with lat; alternative to ll)."
},
"type": {
"enum": [
"search",
"place"
],
"type": "string",
"description": "'search' (default) returns a list of places for q; 'place' returns details for a single place (requires place_id or data_cid)."
},
"start": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Result offset for pagination (0-based); 20 results per page, so use 20, 40, …."
},
"nearby": {
"type": "boolean",
"description": "Search nearby the given coordinates. Default false."
},
"data_cid": {
"type": "string",
"description": "Google Maps CID (data_cid) of a specific place (from a prior search result). Use with type=place; also feeds google_maps_reviews."
},
"location": {
"type": "string",
"description": "Geographic origin of the search — a SerpAPI canonical city-level name, e.g. 'Warsaw,Masovian Voivodeship,Poland'. For a small town or a district, put the place in q instead. SerpAPI requires z or m alongside it — z defaults to 14 when neither is given."
},
"no_cache": {
"type": "boolean",
"description": "Force a fresh SerpAPI fetch and bypass this server's result cache. Default false."
},
"place_id": {
"type": "string",
"description": "Google Maps place_id of a specific place — an opaque string like 'ChIJ…' from a google_maps_search result. A digit-only id is a Google CID (what google_local_search calls place_id) and is sent as data_cid automatically. Use with type=place; also feeds google_maps_reviews."
},
"max_price": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Maximum price-level filter for places."
},
"min_price": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Minimum price-level filter for places."
},
"min_rating": {
"enum": [
"2.0",
"2.5",
"3.0",
"3.5",
"4.0",
"4.5"
],
"type": "string",
"description": "Minimum star-rating filter. Must be a string like '4.0' (a number such as 4.0 stringifies to '4' and breaks the filter)."
},
"open_state": {
"enum": [
"now",
"24h"
],
"type": "string",
"description": "Open-state filter: 'now' = open now, '24h' = open 24 hours. Mutually exclusive with open_on_day/open_at_hour."
},
"zero_trace": {
"type": "boolean",
"description": "Enterprise-only ZeroTrace mode: don't store search params/metadata on SerpAPI. Default false."
},
"open_on_day": {
"enum": [
"mon",
"tue",
"wed",
"thu",
"fri",
"sat",
"sun"
],
"type": "string",
"description": "Filter to places open on a given day (mon-sun). Combine with open_at_hour. Mutually exclusive with open_state."
},
"open_at_hour": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "Filter to places open at a given hour, 0-23. Use with open_on_day. Mutually exclusive with open_state."
},
"google_domain": {
"type": "string",
"description": "Google domain to use, e.g. 'google.com'."
}
}
}