Google Search Results (SERP) API

RapidAPI2026-08-09 更新2026-08-10 收录

搜索引擎结果获取

SEO监控分析

数据链接：

https://rapidapi.com/janschreiberit/api/google-search-results-serp-api3 数据链接链接失效反馈

官方服务：

资源简介：

This API retrieves real-time Google Search results. It returns structured JSON data including titles, URLs, and snippets, while fully supporting pagination, localized searches, and time-based filters for your applications.

创建时间：

2026-08-09

原始信息汇总

数据集概述

Google Search Results (SERP) API 是一个用于实时获取 Google 搜索结果数据的接口，通过结构化 JSON 格式返回结果，包含标题、URL 和摘要等信息。

核心功能

实时数据：直接返回当前 Google 搜索结果的实时数据。
结构化输出：提供包含标题、URL、摘要、排名位置等字段的 JSON 数据。
分页支持：支持自定义起始索引或页码进行分页查询。
本地化搜索：可通过国家/地区代码、语言代码等参数实现特定区域或语言的搜索结果。
时间过滤：支持基于时间的筛选，如过去一天、过去一周或自定义日期范围。
成本优化：按搜索请求计费，而非按搜索结果条目计费，适合批量查询。

请求方式

接口地址：POST /google_serp_scraper-scrape
请求头：需包含 Content-Type: application/json
请求参数（均含于 JSON Body）：
- keyword（必填）：搜索关键词，支持布尔操作符（如 "Elon Musk"、"Adidas site:youtube.com"）。
- limit：每页结果数，可选值：10、20、30、40、50、100，默认 100。
- start：自定义结果起始索引（使用 page 时忽略）。
- page：页码，优先于 start。
- country：ISO 3166-1 alpha-2 国家代码，自动设置代理位置和 gl 参数（如 "US"、"CA"）。
- gl：用于本地化结果的国家代码。
- hl：Google 界面语言代码（如 "en"、"fr"、"zh-CN"）。
- tbs：时间过滤字符串（如 "qdr:d" 为过去一天，或 "cdr:1,cd_min:01/01/2023,cd_max:01/31/2023" 为自定义日期范围）。
- lr：语言限制（如 "lang_en"、"lang_fr"）。
- cr：国家限制（如 "countryUS"、"countryCA"）。
- proxy_location：代理位置，可选值 "us"、"ca"。
- include_merged：是否包含合并结果，默认 true。

响应格式

成功返回 HTTP 200 及 JSON 对象，包含：

status：请求状态（如 "success"）。
scrapedAt：搜索执行的 ISO 8601 时间戳。
resultsCount：results 数组中的结果总数。
results：数组，每个元素包含：
- query：原始搜索词。
- results：单个搜索结果列表，每个条目含 position（排名）、title（标题）、url（链接）、description（摘要）。
- next_page：下一页页码。
- next_start：下一页的起始索引。

速率限制

每个账户允许每秒最多 5 次请求（RPS）。
超过限制将返回 HTTP 429 错误。

错误处理

状态码	错误信息	说明
400	Invalid JSON body	请求体无法解析或未通过 schema 验证
429	Too Many Requests	达到并发限制，需降低请求频率
500	Internal Server Error	服务器内部错误
502	Failed to scrape reviews	上游提取引擎处理失败或超时