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/successAu prix du fournisseur
- 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
Paramètres
| Paramètre | Type | Obligatoire | Description | Exemple |
|---|---|---|---|---|
| Paramètres de requête | ||||
m | nombre | Facultatif | Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z. | |
q | chaîne | Facultatif | 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 | nombre | Facultatif | Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m. | |
gl | chaîne | Facultatif | Two-letter country code used to localize results. Defaults to us. | us |
hl | chaîne | Facultatif | Language code such as en, en-GB, or de. | en |
ll | chaîne | Facultatif | 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 | nombre | Facultatif | Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location. | |
lon | nombre | Facultatif | Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location. | |
data | chaîne | Facultatif | 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 | chaîne | Facultatif | 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 | entier | Facultatif | Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response. | |
nearby | booléen | Facultatif | Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon. | |
timeout | nombre | Facultatif | 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 | chaîne | Facultatif | Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence. | |
location | chaîne | Facultatif | 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 | chaîne | Facultatif | Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence. | ChIJT2h1HKZZwokR0kgzEtsa03k |
max_price | entier | Facultatif | Maximum Google price level, a non-negative integer. Must be at least min_price. | |
min_price | entier | Facultatif | Minimum Google price level, a non-negative integer. Must not exceed max_price. | |
min_rating | nombre | Facultatif | Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear. | |
open_state | chaîne | Facultatif | 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 | chaîne | Facultatif | Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state. | |
open_at_hour | entier | Facultatif | Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state. | |
google_domain | chaîne | Facultatif | Google domain used for the request. | google.com |
- Paramètres de requête
mnombreFacultatifMap radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
qchaîneFacultatifSearch query, such as coffee shops in Austin, TX. Required when type=search. A search needs one of q, place_id, data_cid or data.
Exemple :
coffee shops in Austin, TXznombreFacultatifZoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
glchaîneFacultatifTwo-letter country code used to localize results. Defaults to us.
Exemple :
ushlchaîneFacultatifLanguage code such as en, en-GB, or de.
Exemple :
enllchaîneFacultatifMap 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.
Exemple :
@30.2672,-97.7431,14zlatnombreFacultatifLatitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
lonnombreFacultatifLongitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
datachaîneFacultatifGoogle 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.
typechaîneFacultatifsearch 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.
Exemple :
searchstartentierFacultatifResult offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
nearbybooléenFacultatifSet to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
timeoutnombreFacultatifOptional 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_cidchaîneFacultatifDecimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
locationchaîneFacultatifHuman-readable location to center the map on, such as Austin, Texas. Requires z or m. Mutually exclusive with ll and lat/lon.
Exemple :
Austin, Texas, United Statesplace_idchaîneFacultatifGoogle Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
Exemple :
ChIJT2h1HKZZwokR0kgzEtsa03kmax_priceentierFacultatifMaximum Google price level, a non-negative integer. Must be at least min_price.
min_priceentierFacultatifMinimum Google price level, a non-negative integer. Must not exceed max_price.
min_ratingnombreFacultatifMinimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
open_statechaîneFacultatifnow returns places open now; 24h returns places open 24 hours. Cannot be combined with open_on_day or open_at_hour.
open_on_daychaîneFacultatifReturn places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hourentierFacultatifHour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domainchaîneFacultatifGoogle domain used for the request.
Exemple :
google.com
Exemples de code
Remplacez $TOOLSWITCH_KEY par la clé créée dans la 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());Cette API de passerelle est en préversion ; son URL et son authentification peuvent changer. Les paramètres de l’exemple sont des données fictives. Les appels sont facturés à $0.00015/success, frais de service inclus.