用 Google API 查询关键词排名：2026 年指南

关于作者

Thibault Besson-Magdelain

Sorank 创始人，拥有 5 年以上 SEO 经验，GEO 爱好者。

简而言之：Google 并未提供返回实时关键词排名的 API。Search Console API 返回的是您已验证站点已有排名的查询词的平均位置：免费、第一方数据，但仅限于您自己的站点，而且是一段时间内的平均值。Custom Search JSON API 返回的是自定义搜索引擎的结果，而不是 google.com 的结果，因此它的位置与用户看到的并不一致。如果您需要真实的实时 SERP 位置（包括竞争对手的），就需要第三方 SERP API。本指南给出每条路线可用的代码，以及它们各自失效的地方。

想用 Google API 查询关键词排名，这类任务看上去已经有现成答案，直到您真的动手去做。根本不存在 rankings.get() 这样的接口，而人们最先想到的那两个 Google API，回答的其实是与问题微妙不同的另一个问题。Search Console Search Analytics 文档是合适的起点，前提是您明白其中的「位置」到底指什么。

Google 有官方的关键词排名 API 吗？

没有。Google 从未发布过一个可以传入关键词、返回您在 google.com 上实时位置的 API。这是有意为之：自动查询搜索结果页违反 Google 的条款，而且这家公司也没有任何商业动机去提供排名追踪的基础设施。

现实中存在的是三条不完整的路线，每一条都有明确的边界：

路线	返回内容	能看竞争对手吗？	费用
Search Console API	平均位置，仅限您自己的站点	不能	免费
Custom Search JSON API	自定义搜索引擎的结果	能，但不是真实 SERP	每天 100 次查询免费
第三方 SERP API	实时、精确的 SERP 位置	能	付费，按查询次数计费

如何从 Search Console API 获取关键词位置？

带上 query 维度调用 searchAnalytics 接口，读取 position 字段即可。这是直接来自 Google 的第一方数据，免费，且没有关键词数量限制：您能拿到站点获得过展现的每一个查询词。

可用的请求，Python 版本：

from google.oauth2 import service_account
from googleapiclient.discovery import build

creds = service_account.Credentials.from_service_account_file(
    "service-account.json",
    scopes=["https://www.googleapis.com/auth/webmasters.readonly"],
)
service = build("searchconsole", "v1", credentials=creds)

response = service.searchanalytics().query(
    siteUrl="https://example.com/",
    body={
        "startDate": "2026-07-01",
        "endDate": "2026-07-31",
        "dimensions": ["query", "page"],
        "rowLimit": 25000,
    },
).execute()

for row in response.get("rows", []):
    query, page = row["keys"]
    print(f"{row['position']:.1f}  {query}  ->  {page}")

电脑显示器上展示着带有效果图表的分析仪表盘 — Search Console 返回的是平均位置数据，而不是实时排名快照。

三个容易让人栽跟头的限制

位置是平均值，不是排名。7.4 并不意味着您稳在第 7 位，而是说展现分布在平均为 7.4 的位置上，在不同设备和地区间可能从第 3 位跨到第 15 位。
只能看自己的站点。无法查看竞争对手的位置。Search Console 在设计上就是一个按站点限定范围的 API。
零展现的关键词是看不见的。如果您排在第 60 位而没有人翻到那里，这个查询词根本不会出现在数据里。

第三点正是悄无声息地毁掉报告的那一条。一个您尚未打进前几页的关键词，在 Search Console 里干脆就不存在，这使得单靠这个 API 无法衡量从第 60 位到第 20 位的进展。

能用 Custom Search JSON API 查排名吗？

技术上可以，但没有意义。Custom Search JSON API 要求您先创建一个可编程搜索引擎。即使配置为搜索整个网络，它依然使用自己的排序逻辑和自己的限制，因此它返回的顺序并不是 google.com 返回的顺序。

它的免费层还限定每天 100 次查询，付费使用按每千次查询计费，并设有每日上限。偶尔查几个关键词，它还能用。但当作排名追踪工具，它产出的数字看上去很权威，实际却静静地错了，这比没有数据更糟糕。

直接抓取 Google 呢？

不要这么做。未经允许自动查询 Google 搜索违反了 Google 的服务条款，而且只要量一大，就会招来 IP 封禁和验证码拦截。抛开合规问题不谈，工程上的现实也很棘手：搜索结果是个性化、本地化的，而且越来越多地叠加了 AI 功能，因此即使您的网站毫无变化，抓取到的「位置」也会因数据中心、地点和会话而不同。

如果您需要竞争对手的位置，商业 SERP API 才是既符合服务商协议、运行上又稳定的路线。它是一笔付费支出，而这笔成本就是 Google 不白送的数据应有的价格。需要搭建并监控这套数据管道、又不想自建团队的企业，通常会引入专业服务商；我们对法国十佳数据分析代理机构的对比中，就列出了能搭建这类报告体系的服务商。