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/successPelo preço do provedor
- Success rate
- 96,1%Last 30 days · 904.703 calls
- Latency p50
- 6.4 sp95 16 s
- Last verified
- 29 de set. de 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 | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| 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 | string | 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 | string | Opcional | Two-letter country code used to localize results. Defaults to us. | us |
hl | string | Opcional | Language code such as en, en-GB, or de. | en |
ll | string | 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 | string | 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 | string | 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 | inteiro | 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 | string | Opcional | Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence. | |
location | string | 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 | string | Opcional | Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence. | ChIJT2h1HKZZwokR0kgzEtsa03k |
max_price | inteiro | Opcional | Maximum Google price level, a non-negative integer. Must be at least min_price. | |
min_price | inteiro | 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 | string | 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 | string | Opcional | Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state. | |
open_at_hour | inteiro | 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 | string | 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.
qstringOpcionalSearch query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.
Exemplo:
coffee shops in Austin, TXznúmeroOpcionalZoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
glstringOpcionalTwo-letter country code used to localize results. Defaults to us.
Exemplo:
ushlstringOpcionalLanguage code such as en, en-GB, or de.
Exemplo:
enllstringOpcionalMap 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.
Exemplo:
@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.
datastringOpcionalGoogle 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.
typestringOpcionalsearch 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.
Exemplo:
searchstartinteiroOpcionalResult 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_cidstringOpcionalDecimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
locationstringOpcionalHuman-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.
Exemplo:
Austin, Texas, United Statesplace_idstringOpcionalGoogle Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
Exemplo:
ChIJT2h1HKZZwokR0kgzEtsa03kmax_priceinteiroOpcionalMaximum Google price level, a non-negative integer. Must be at least min_price.
min_priceinteiroOpcionalMinimum 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_statestringOpcionalnow returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
open_on_daystringOpcionalReturn places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hourinteiroOpcionalHour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domainstringOpcionalGoogle domain used for the request.
Exemplo:
google.com
Exemplos de código
Substitua $TOOLSWITCH_KEY pela chave criada no console.
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());Esta API de gateway está em prévia; a URL e a autenticação podem mudar. Os parâmetros do exemplo são dados de amostra. As chamadas são cobradas a $0.00015/success, incluindo a taxa de serviço.