LitescrapeGoogleSEO/AEO

Search Google Maps

litescrape.google.serp.maps

Search Google Maps with q and type=search to get up to 20 places in local_results, or look up one exact place by place_id, data_cid or data to get place_results

Price: $0.00015/successAt provider cost
Success rate: 96.1%Last 30 days · 904,703 calls
Latency p50: 6.4 sp95 16 s
Last verified: Sep 29, 2026Verified working

GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=searchPreview

Try onlineComing soonProvider docs ↗

Uses platform quota
Synchronous response
Reads public data

Parameters

Parameter	Type	Required	Description	Example
Query parameters
`m`	number	Optional	Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
`q`	string	Optional	Search query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.	`coffee shops in Austin, TX`
`z`	number	Optional	Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
`gl`	string	Optional	Two-letter country code used to localize results. Defaults to us.	`us`
`hl`	string	Optional	Language code such as en, en-GB, or de.	`en`
`ll`	string	Optional	Map viewport as @latitude,longitude,zoomz or @latitude,longitude,radiusm, for example @30.2672,-97.7431,14z. Already includes its scale, so do not add z or m. Mutually exclusive with location and lat/lon.	`@30.2672,-97.7431,14z`
`lat`	number	Optional	Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
`lon`	number	Optional	Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
`data`	string	Optional	Google Maps protobuf sequence copied from a Maps URL, beginning with ! and at most 8,192 characters. A sequence that identifies one place requires type=place and is mutually exclusive with place_id and data_cid.
`type`	string	Optional	search returns a list of places in local_results; place returns one exact place in place_results. Required when searching by q or by filter data, and type=place is required with an exact-place data sequence. Can be omitted with place_id or data_cid.	`search`
`start`	integer	Optional	Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
`nearby`	boolean	Optional	Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
`timeout`	number	Optional	Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
`data_cid`	string	Optional	Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
`location`	string	Optional	Human-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.	`Austin, Texas, United States`
`place_id`	string	Optional	Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.	`ChIJT2h1HKZZwokR0kgzEtsa03k`
`max_price`	integer	Optional	Maximum Google price level, a non-negative integer. Must be at least min_price.
`min_price`	integer	Optional	Minimum Google price level, a non-negative integer. Must not exceed max_price.
`min_rating`	number	Optional	Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
`open_state`	string	Optional	now returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
`open_on_day`	string	Optional	Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
`open_at_hour`	integer	Optional	Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
`google_domain`	string	Optional	Google domain used for the request.	`google.com`

Query parameters
mnumberOptional
Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
qstringOptional
Search query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.
Example: coffee shops in Austin, TX
znumberOptional
Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
glstringOptional
Two-letter country code used to localize results. Defaults to us.
Example: us
hlstringOptional
Language code such as en, en-GB, or de.
Example: en
llstringOptional
Map viewport as @latitude,longitude,zoomz or @latitude,longitude,radiusm, for example @30.2672,-97.7431,14z. Already includes its scale, so do not add z or m. Mutually exclusive with location and lat/lon.
Example: @30.2672,-97.7431,14z
latnumberOptional
Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
lonnumberOptional
Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
datastringOptional
Google Maps protobuf sequence copied from a Maps URL, beginning with ! and at most 8,192 characters. A sequence that identifies one place requires type=place and is mutually exclusive with place_id and data_cid.
typestringOptional
search returns a list of places in local_results; place returns one exact place in place_results. Required when searching by q or by filter data, and type=place is required with an exact-place data sequence. Can be omitted with place_id or data_cid.
Example: search
startintegerOptional
Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
nearbybooleanOptional
Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
timeoutnumberOptional
Optional budget for the entire request in seconds, measured from gateway receipt until the response is ready to send. Includes admission, queueing and settlement. Must be greater than 0 and at most 90. On expiry, the call is not billed and returns 503 request_deadline_exceeded with retryable=true and a request ID. Omit to retain the standard server deadline.
data_cidstringOptional
Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
locationstringOptional
Human-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.
Example: Austin, Texas, United States
place_idstringOptional
Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
Example: ChIJT2h1HKZZwokR0kgzEtsa03k
max_priceintegerOptional
Maximum Google price level, a non-negative integer. Must be at least min_price.
min_priceintegerOptional
Minimum Google price level, a non-negative integer. Must not exceed max_price.
min_ratingnumberOptional
Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
open_statestringOptional
now returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
open_on_daystringOptional
Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hourintegerOptional
Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domainstringOptional
Google domain used for the request.
Example: google.com

Code samples

Replace $TOOLSWITCH_KEY with the key you created in the console.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=search", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at $0.00015/success, including the service fee.