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"}'
字段类型示例值
请求体
querystring"best running shoes 2026"Google 搜索查询词。
autocorrectboolean开关 Google 拼写自动纠正(默认 true)。设为 false 则按原查询精确搜索,不做纠正。
cursorstring已弃用:请改为发送 page。仍接受之前响应中 nextCursor 返回的续传令牌,并且仍会在签发它的数据源上继续;与 cursor 一起发送时,page 会被忽略。
glstring"us"用于结果本地化的两字母国家代码(例如 us、gb、de)。
hlstring两字母界面和结果语言代码(例如 en、es、de)。
limitinteger本次响应最多返回的自然搜索结果数。Google 自 2025 年 9 月起不再支持批量结果数,所以一页约 10 条结果;上限高于 10 会被接受,但不会返回更多。要看更深的结果,请发送 page(每页约 10 条,每页按一次请求计费),或使用 google.search_100:它一次调用最多返回 100 条排名结果,统一收费一次,超过大约 20 条结果时更便宜。按请求固定计费。
locationstring用于结果本地化的精细地点,比国家级的 gl 更具体。必须与 Google 地理定位列表中的某个 Active Canonical Name 完全一致,该列表的逗号后不加空格:'New York,New York,United States'、'Austin,Texas,United States'、'London,England,United Kingdom'。不匹配的值会被拒绝,而不是悄悄换成别的地点来搜索。
pageinteger要返回第几页自然搜索结果(每页约 10 条),从 1 开始。发送 page 2、3……可继续往深处翻;每页按一次请求计费,任何数据源都能处理任何一页。取代 cursor。
requireCursorboolean已弃用。此搜索的每个数据源都会返回 nextCursor,所以它不会改变价格,也不会改变由哪个数据源处理;它仍被接受,以便已在发送它的调用方继续正常工作。
timeframeenum将结果限制在最近的时间窗口内:1h、1d、7d、1y 或 all。默认 all(不限时间)。
响应
foundbooleantrue
dataobject
data.querystring"best running shoes 2026"
data.resultsarray
data.results[].titlestring"The 12 Best Running Shoes of 2026, Tested by Runners"
data.results[].linkstring"https://www.example.com/best-running-shoes"
data.results[].snippetstring"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[].positionnumber1
价格
每次请求价格USDUS$0.0004
价格(/千次请求)USDUS$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 对经过网关的流量的自有测量,持续重新计算,并非公开承诺的服务等级目标。