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

价格: $0.00015/success按供应商原价
成功率: 96.1%近 30 天 · 904,703 次
延迟 p50: 6.4 秒p95 16 秒
最后验证: 2026年9月29日实测可用

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

在线试用即将上线供应商文档 ↗

可用平台额度调用
同步返回
读取公开数据

参数

参数	类型	必填	说明	示例
查询参数
`m`	数字	可选	Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
`q`	字符串	可选	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`	数字	可选	Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
`gl`	字符串	可选	Two-letter country code used to localize results. Defaults to us.	`us`
`hl`	字符串	可选	Language code such as en, en-GB, or de.	`en`
`ll`	字符串	可选	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`	数字	可选	Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
`lon`	数字	可选	Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
`data`	字符串	可选	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`	字符串	可选	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`	整数	可选	Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
`nearby`	布尔	可选	Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
`timeout`	数字	可选	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`	字符串	可选	Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
`location`	字符串	可选	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`	字符串	可选	Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.	`ChIJT2h1HKZZwokR0kgzEtsa03k`
`max_price`	整数	可选	Maximum Google price level, a non-negative integer. Must be at least min_price.
`min_price`	整数	可选	Minimum Google price level, a non-negative integer. Must not exceed max_price.
`min_rating`	数字	可选	Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
`open_state`	字符串	可选	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`	字符串	可选	Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
`open_at_hour`	整数	可选	Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
`google_domain`	字符串	可选	Google domain used for the request.	`google.com`

查询参数
m数字可选
Map radius in meters, from 1 through 15,028,132. Use with location or lat/lon. Mutually exclusive with z.
q字符串可选
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数字可选
Zoom level from 3 through 30. Use with location or lat/lon. Mutually exclusive with m.
gl字符串可选
Two-letter country code used to localize results. Defaults to us.
示例：us
hl字符串可选
Language code such as en, en-GB, or de.
示例：en
ll字符串可选
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数字可选
Latitude of the map center. Supply with lon and either z or m. Mutually exclusive with ll and location.
lon数字可选
Longitude of the map center. Supply with lat and either z or m. Mutually exclusive with ll and location.
data字符串可选
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字符串可选
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整数可选
Result offset in steps of 20: 0, 20, 40 and so on. Prefer following pagination.next from the previous response.
nearby布尔可选
Set to true to remove near me wording from the query so the supplied viewport is used. Requires ll, location or lat/lon.
timeout数字可选
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字符串可选
Decimal Google CID for an exact-place lookup. Mutually exclusive with place_id and an exact-place data sequence.
location字符串可选
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字符串可选
Google Place ID for an exact-place lookup. Mutually exclusive with data_cid and an exact-place data sequence.
示例：ChIJT2h1HKZZwokR0kgzEtsa03k
max_price整数可选
Maximum Google price level, a non-negative integer. Must be at least min_price.
min_price整数可选
Minimum Google price level, a non-negative integer. Must not exceed max_price.
min_rating数字可选
Minimum star rating. Google treats it as a relevance preference, so lower-rated or unrated places may still appear.
open_state字符串可选
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字符串可选
Return places open on this weekday, optionally at open_at_hour. Cannot be combined with open_state.
open_at_hour整数可选
Hour from 0 through 23 at which the place must be open. Requires open_on_day. Cannot be combined with open_state.
google_domain字符串可选
Google domain used for the request.
示例：google.com

代码示例

将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。

预览

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());

网关接口为预览版，地址与鉴权方式可能调整。示例参数仅为样例数据。调用按 $0.00015/success 计费，已含服务费。