提取 Google 搜索结果、自然排名、结果 URL、标题、摘要及相关搜索词，以结构化 JSON 用于 SERP 监控、排名跟踪和搜索可见性工作流。
Structured output
使用 Crawlora 的 Google Search API，无需自建解析器、代理路由、重试机制或响应规范化层，即可采集公开的 Google SERP 数据。该端点返回的结构化 JSON 可为排名跟踪工具、SEO 仪表盘、关键词监控工具、竞品研究和 AI 搜索工作流提供支持。
SERP 工作流
Crawlora 帮助团队记录各域名在 Google 中的排名情况、出现的结果 URL 和摘要，以及跨关键词、国家和语言的排名随时间的变化。
SERP 监控工作流Request schema
These parameters come from the active Google search API catalog entry.
| Parameter | Type | Required | Description | Example |
|---|
Example JSON
This example is rendered from the active endpoint catalog so the page stays aligned with Docs and Playground.
{
"code": 200,
"msg": "OK",
"data": {
"result": [
{
"position": 1,
"title": "ChatGPT",
"website_name": "ChatGPT",
"icon": "",
"link": "https://chatgpt.com/",
"Snippet": "ChatGPT helps you get answers and create."
}
],
"ai_overview": {
"heading": "AI Overview",
"summary": "ChatGPT is a generative AI chatbot developed by OpenAI that can answer questions and hold conversations.",
"sources": [
"https://openai.com/chatgpt/"
]
},
"people_also_ask": [
{
"question": "What is ChatGPT used for?"
}
]
}
}Endpoint catalog
/google/searchReturns normalized Google web search results. Results are fetched through proxied browser renderers that race several concurrent renders per request and return the first clean result, with stale-cache fallback when available. The endpoint returns 503 when Google serves a challenge page or unusable HTML. Rate limit is enforced at 1 request per second, and if the limit is exceeded a 429 status code is returned with rate limit headers.
MCP tool google_search
Managed execution
针对支持的公开 Google 搜索结果页，Crawlora 将请求处理、代理感知采集、响应解析和文档化的错误行为封装在一个稳定的 API 界面之后。
针对 Google 网页搜索结果页的请求逻辑
在支持范围内提供代理感知采集和重试感知执行
针对不可用上游响应的验证感知处理
带 Playground 测试示例的规范化 JSON 响应
基于文档化端点成本的额度计费
Crawlora 会检测不可用的上游响应，并返回文档化的错误，而不是静默返回损坏的 HTML。
Build or buy
Use this comparison to decide whether to maintain scraping infrastructure internally or call a managed endpoint.
| Requirement | Building internally | Crawlora |
|---|---|---|
| 代理轮换 | 需要购买、测试、轮换并监控代理池。 | 在支持范围内使用受管理的代理感知采集。 |
| 解析器维护 | 需要随 Google 页面布局的变化维护选择器。 | 使用 API 背后维护的解析器。 |
| 架构规范化 | 需要设计并维护自己的响应模型版本。 | 从目录中获取文档化的 JSON 字段。 |
| 重试与错误分类 | 需要自行区分验证页、空页面和上游故障。 | 针对不可用的上游响应获取文档化的错误。 |
| 端点文档 | 需要编写并维护内部 API 文档。 | 使用当前活跃端点目录生成的 Docs 页面。 |
| Playground 测试 | 需要为开发者构建测试控制台。 | 上线前先在 Playground 中测试同一个端点。 |
| 用量计费 | 需要自建计量和限制系统。 | 使用基于额度的用量和套餐限制。 |
| 监控 | 需要从零搭建请求量和故障的监控体系。 | 使用 Crawlora 文档化的状态和用量工作流。 |
Crawlora 并非 Google 官方的 Custom Search 或 Programmable Search API。Crawlora 为支持的 Google 搜索结果页提供结构化网络公开数据提取端点。如果你的用例需要 Google 官方授权的搜索 API，请使用 Google 官方 API。
Related APIs
Connect this endpoint with adjacent Crawlora search, monitoring, docs, and pricing pages.
将 Google 可见性与 Bing 的 SERP 数据进行比较。
Open将 Brave Search 的结果加入跨引擎监控工作流。
Open将 SERP 跟踪与搜索需求和趋势发现结合起来。
Open跟踪关键词排名、结果变化和搜索可见性。
Open基于周期性搜索结果快照构建关键词跟踪仪表盘。
Open存储用于关键词、URL 和竞品监控的周期性 SERP 检查。
Open通过结构化的 Google 结果快照检查关键词排名和排名 URL。
Open将 Crawlora 用作代理机构和 SaaS SEO 报告背后的数据层。
OpenHow to scrape Google Search
Crawlora 的 /google/search 端点是一个 POST 请求，接受 keyword、country、language、limit（结果数量上限）和 page 参数，返回规范化 JSON 形式的 Google 网页搜索结果页——包含排名位置、标题、URL、域名和摘要的自然结果，以及相关搜索词和分页元数据。请求通过代理浏览器渲染器发起，会并行竞速多次渲染并返回最先获得的干净结果，并具备陈旧缓存回退机制；遇到 Google 验证页时会返回文档化的错误，而不是损坏的 HTML。
对 /google/search 发起 POST 请求，请求体为 JSON：keyword、country（例如 us）、language（en）、limit（不超过文档规定的上限）和 page。country 和 language 决定了应答的是哪个 Google 前端，因此排名跟踪工具应为每个关键词固定这两个参数，而不是使用默认值。
每条自然结果都带有 position、title、link、website_name（域名）和 Snippet。position 就是 Google 针对该地区和页码给出的页面排名，这正是排名跟踪所需要的数据；用 website_name 匹配你的域名，并记录带有获取时间戳的排名位置。
增大 page 并保持 limit 不变，即可读取首页之后的结果。每次运行为每个关键词的每一页存储一条记录，这样多次运行之间的变化就是一次差异对比，而不是重新解析。
使用 Crawlora 的 /google/news 和 /google/videos 端点（GET，参数为 q、country 和 lang）获取新闻和视频垂直搜索结果，用 /google/suggest 获取自动补全建议，用 /google/jobs 获取招聘信息。Bing、Brave 和 DuckDuckGo 的搜索端点返回相同的结构，因此跨引擎的可见性对比只需更换路径即可复用相同代码。
FAQ
Answers for developers evaluating Crawlora for supported public search result pages.
是的。Crawlora 为支持的公开 Google 搜索结果页提供 Google Search 端点，并通过文档化的 API 路由返回规范化 JSON。
可以。每个响应都包含自然结果的排名位置、标题、URL 和摘要，因此你可以随时间记录关键词排名并检测 SERP 变化。将周期性快照与 SERP 监控应用场景结合，即可构建 Google 排名跟踪工具。
目录示例包括带有排名位置、标题、URL、描述、域名和分页元数据的自然结果，以及 Google 提供时的相关搜索词。
支持。Google Search 端点接受 keyword、country、language、limit 和 page 参数。
Crawlora 会检测不可用的上游响应并返回文档化的错误，而不是静默返回损坏的 HTML。客户应在自己的集成中处理错误、重试和上游可用性变化。
不是。Crawlora 并非 Google 官方的 Custom Search 或 Programmable Search API。Crawlora 为支持的 Google 搜索结果页提供结构化网络公开数据提取端点。如果你的用例需要 Google 官方授权的搜索 API，请使用 Google 官方 API。
对 Crawlora 的 /google/search 端点发起 POST 请求，带上 keyword、country、language、limit 和 page。响应即为该结果页的 JSON 形式：包含 position、title、link、域名和摘要的自然结果、相关搜索词以及分页元数据。你这边无需运行代理、浏览器或解析器。
是的。每条自然结果的 position 就是 Google 在请求时针对该关键词、国家、语言和页码给出的排名。这是字面意义上的 SERP，而不是按相关性重新排序的列表，因此适用于排名跟踪和声量份额分析。
请求会并行竞速多次代理浏览器渲染，返回最先获得的干净结果，并具备陈旧缓存回退机制。如果没有可用的干净结果，Crawlora 会返回文档化的错误代码，而不是把验证页伪装成结果返回，并且该次调用不会按成功计费。
可以。Crawlora 的 /google/news、/google/videos 和 /google/suggest 端点是 GET 请求，接受 q、country 和 lang 参数；/google/jobs 是 POST 请求。它们与网页搜索共用同一个 API 密钥和额度池。
在遵守 Google 服务条款、速率限制和适用法律的前提下，为研究和监控目的采集公开搜索结果页通常是被允许的；搜索结果本身是公开的。请负责任地使用数据，并在大规模采集前先了解基本的法律要点。
在 Playground 中测试 /google/search，在 Docs 中查看当前的响应架构，并在价格页面比较基于额度的用量。