Google API
Google 网页搜索 API
运行 Google 网页搜索,获取自然搜索结果:标题、链接、摘要和排名位置。
POST/v1/run/google.search
可用率
99.72%
30d · 350,873 次调用
请求数
350,969
30d · 按周,近 12 周
响应时间
4.0s
中位数 · 30d
服务商网络
按流量排序的服务商
试一试
发出你的第一个请求
示例响应
免费运行只返回前 3 条结果。为密钥充值即可获得完整响应。
{
"found": true,
"data": {
"query": "best running shoes 2026",
"results": [
{
"title": "The 12 Best Running Shoes of 2026, Tested by Runners",
"link": "https://www.example.com/best-running-shoes",
"snippet": "We logged hundreds of miles in this year’s top trainers to find the best running shoes for every type of runner and budget.",
"position": 1
}
]
}
}响应类型定义
interface GoogleSearchResponse {
data: {
nextCursor?: string | null;
query: string;
results: {
link: string;
position: number;
snippet: string;
title: string;
}[];
} | null;
found: boolean;
reason?: "not_found";
}完整的参数与响应参考:这个接口的每个字段、类型和示例。
参考
请求、响应与价格
最近验证于 2026-09-29 · 可用率和延迟按 30d 统计POST /v1/run/google.search
curl -X POST https://api.getanyapi.com/v1/run/google.search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"best running shoes 2026","gl":"us"}'| 字段 | 类型 | 示例值 |
|---|---|---|
| 请求体 | ||
| query | string | "best running shoes 2026"Google 搜索查询词。 |
| autocorrect | boolean | 开关 Google 拼写自动纠正(默认 true)。设为 false 则按原查询精确搜索,不做纠正。 |
| cursor | string | 已弃用:请改为发送 page。仍接受之前响应中 nextCursor 返回的续传令牌,并且仍会在签发它的数据源上继续;与 cursor 一起发送时,page 会被忽略。 |
| gl | string | "us"用于结果本地化的两字母国家代码(例如 us、gb、de)。 |
| hl | string | 两字母界面和结果语言代码(例如 en、es、de)。 |
| limit | integer | 本次响应最多返回的自然搜索结果数。Google 自 2025 年 9 月起不再支持批量结果数,所以一页约 10 条结果;上限高于 10 会被接受,但不会返回更多。要看更深的结果,请发送 page(每页约 10 条,每页按一次请求计费),或使用 google.search_100:它一次调用最多返回 100 条排名结果,统一收费一次,超过大约 20 条结果时更便宜。按请求固定计费。 |
| location | string | 用于结果本地化的精细地点,比国家级的 gl 更具体。必须与 Google 地理定位列表中的某个 Active Canonical Name 完全一致,该列表的逗号后不加空格:'New York,New York,United States'、'Austin,Texas,United States'、'London,England,United Kingdom'。不匹配的值会被拒绝,而不是悄悄换成别的地点来搜索。 |
| page | integer | 要返回第几页自然搜索结果(每页约 10 条),从 1 开始。发送 page 2、3……可继续往深处翻;每页按一次请求计费,任何数据源都能处理任何一页。取代 cursor。 |
| requireCursor | boolean | 已弃用。此搜索的每个数据源都会返回 nextCursor,所以它不会改变价格,也不会改变由哪个数据源处理;它仍被接受,以便已在发送它的调用方继续正常工作。 |
| timeframe | enum | 将结果限制在最近的时间窗口内:1h、1d、7d、1y 或 all。默认 all(不限时间)。 |
| 响应 | ||
| found | boolean | true |
| data | object | |
| data.query | string | "best running shoes 2026" |
| data.results | array | |
| data.results[].title | string | "The 12 Best Running Shoes of 2026, Tested by Runners" |
| data.results[].link | string | "https://www.example.com/best-running-shoes" |
| data.results[].snippet | string | "We logged hundreds of miles in this year’s top trainers to find the best running shoes for every type of runner and budget." |
| data.results[].position | number | 1 |
| 价格 | ||
| 每次请求价格 | USD | US$0.0004 |
| 价格(/千次请求) | USD | US$0.40 |
常见问题
关于 Google 网页搜索 API
AnyAPI 的 Google 网页搜索 API 只需一次 POST 请求 /v1/run/google.search,就以统一格式的 JSON 返回 Google 数据。运行 Google 网页搜索,获取自然搜索结果:标题、链接、摘要和排名位置。AnyAPI 会在 4 个数据源之间路由每个请求,某个数据源失败时自动切换。费用:每千次请求 US$0.40 起,以美元计价,无需订阅,也没有每月最低消费。过去 30 天,通过 AnyAPI 发起的 Google 网页搜索 API 调用中有 99.7% 成功,响应时间中位数为 4.0 秒,共测量 350,873 次调用。
费用:每千次请求 US$0.40 起,以美元计价,无需订阅,也没有每月最低消费。你只需为一个美元钱包充值,每次调用从中扣费。部分由钱包付费的失败请求会产生处理费用,我们按成本原价转嫁,不加价;错误响应会显示收取的金额。
运行 Google 网页搜索,获取自然搜索结果:标题、链接、摘要和排名位置。响应是统一格式的 JSON,外层结构与每个 AnyAPI 接口相同,所以解析另一个接口只需换一个 URL,别的都不用改。
过去 30 天,通过 AnyAPI 发起的 Google 网页搜索 API 调用中有 99.7% 成功,响应时间中位数为 4.0 秒,共测量 350,873 次调用。这些是 AnyAPI 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。