Find Google Search ads
litescrape.google.serp.adsReturns the Google results page for a query at a named location, including the ads, local_ads, and shopping_results groups when Google serves them
- 价格
- $0.00015/success按供应商原价
- 成功率
- 76.5%近 30 天 · 2,446 次
- 延迟 p50
- 4.3 秒p95 39 秒
- 最后验证
- 2026年9月29日实测可用
GEThttps://toolswitch.dev/v1/tools/litescrape.google.serp.ads?q=running+shoes&location=Austin%2C+Texas%2C+United+States预览- 可用平台额度调用
- 同步返回
- 读取公开数据
参数
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 查询参数 | ||||
q | 字符串 | 必填 | Google Ads query, up to 2,048 characters with no control characters. | coffee maker |
hl | 字符串 | 可选 | Google interface and result language, such as en, en-US, or de. Defaults to en. | en |
nfpr | 字符串 | 可选 | Set 1 to disable Google spelling auto-correction, or 0 to allow it. | |
safe | 字符串 | 可选 | Google adult-content filtering: active or off. | |
device | 字符串 | 可选 | Google returns its real layout for the selected device: desktop, tablet, or mobile. | desktop |
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. | |
location | 字符串 | 必填 | Named location to search from, up to 512 characters and at most 63 bytes once URL-encoded. | Austin, Texas, United States |
- 查询参数
q字符串必填Google Ads query, up to 2,048 characters with no control characters.
示例：
coffee makerhl字符串可选Google interface and result language, such as en, en-US, or de. Defaults to en.
示例：
ennfpr字符串可选Set 1 to disable Google spelling auto-correction, or 0 to allow it.
safe字符串可选Google adult-content filtering: active or off.
device字符串可选Google returns its real layout for the selected device: desktop, tablet, or mobile.
示例：
desktoptimeout数字可选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.
location字符串必填Named location to search from, up to 512 characters and at most 63 bytes once URL-encoded.
示例：
Austin, Texas, United States
代码示例
将 $TOOLSWITCH_KEY 替换为你在控制台创建的密钥。
curl -X GET 'https://toolswitch.dev/v1/tools/litescrape.google.serp.ads?q=running+shoes&location=Austin%2C+Texas%2C+United+States' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/litescrape.google.serp.ads?q=running+shoes&location=Austin%2C+Texas%2C+United+States",
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.ads?q=running+shoes&location=Austin%2C+Texas%2C+United+States", {
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 计费，已含服务费。