Search Google Maps
litescrape.google.serp.mapsSearch 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/successAl precio del proveedor
- Success rate
- 96,1 %Last 30 days · 904.703 calls
- Latency p50
- 6.4 sp95 16 s
- Last verified
- 29 sept 2026Verified working
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.maps?q=coffee+shops+in+Austin+TX&type=searchPreview- Uses platform quota
- Synchronous response
- Reads public data
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción | Ejemplo |
|---|---|---|---|---|
| Parámetros de consulta | ||||
m | número | Opcional | Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z. | |
q | cadena | Opcional | 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 | número | Opcional | Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m. | |
gl | cadena | Opcional | Two-letter country code used to localize results. Defaults to us. | us |
hl | cadena | Opcional | Language code such as en, en-GB, or de. | en |
ll | cadena | Opcional | 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 | número | Opcional | Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location. | |
lon | número | Opcional | Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location. | |
data | cadena | Opcional | 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 | cadena | Opcional | 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 | entero | Opcional | Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response. | |
nearby | booleano | Opcional | Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon. | |
timeout | número | Opcional | 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 | cadena | Opcional | Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence. | |
location | cadena | Opcional | 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 | cadena | Opcional | Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence. | ChIJT2h1HKZZwokR0kgzEtsa03k |
max_price | entero | Opcional | Maximum Google price level, a non-negative integer. Must be at least min_price. | |
min_price | entero | Opcional | Minimum Google price level, a non-negative integer. Must not exceed max_price. | |
min_rating | número | Opcional | Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear. | |
open_state | cadena | Opcional | 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 | cadena | Opcional | Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state. | |
open_at_hour | entero | Opcional | Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state. | |
google_domain | cadena | Opcional | Google domain used for the request. | google.com |
- Parámetros de consulta
mnúmeroOpcionalMap radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
qcadenaOpcionalSearch query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.
Ejemplo:
coffee shops in Austin, TXznúmeroOpcionalZoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
glcadenaOpcionalTwo-letter country code used to localize results. Defaults to us.
Ejemplo:
ushlcadenaOpcionalLanguage code such as en, en-GB, or de.
Ejemplo:
enllcadenaOpcionalMap 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.
Ejemplo:
@30.2672,-97.7431,14zlatnúmeroOpcionalLatitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
lonnúmeroOpcionalLongitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
datacadenaOpcionalGoogle 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.
typecadenaOpcionalsearch 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.
Ejemplo:
searchstartenteroOpcionalResult offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
nearbybooleanoOpcionalSet to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
timeoutnúmeroOpcionalOptional 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_cidcadenaOpcionalDecimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
locationcadenaOpcionalHuman-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.
Ejemplo:
Austin, Texas, United Statesplace_idcadenaOpcionalGoogle Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
Ejemplo:
ChIJT2h1HKZZwokR0kgzEtsa03kmax_priceenteroOpcionalMaximum Google price level, a non-negative integer. Must be at least min_price.
min_priceenteroOpcionalMinimum Google price level, a non-negative integer. Must not exceed max_price.
min_ratingnúmeroOpcionalMinimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
open_statecadenaOpcionalnow returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
open_on_daycadenaOpcionalReturn places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hourenteroOpcionalHour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domaincadenaOpcionalGoogle domain used for the request.
Ejemplo:
google.com
Ejemplos de código
Sustituye $TOOLSWITCH_KEY por la clave que creaste en la consola.
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());La API de la pasarela está en versión preliminar; su URL y autenticación pueden cambiar. Los parámetros del ejemplo son datos de muestra. Las llamadas se facturan a $0.00015/success, incluida la tarifa de servicio.