Google SERP - Search Results JSON

Real-time Google search results as SerpApi-compatible JSON: organic results, local pack, knowledge graph, answer box, AI Overview, videos, news and People Also Ask. Location targeting, real links.

原始信息汇总

Google SERP - Search Results JSON

基本信息

• 名称：Google SERP - Search Results JSON
• 页面地址：https://rapidapi.com/fiery-tools-fiery-tools-default/api/google-serp-search-results-json
• API 版本：1.0.0（current）
• 分类：Search
• 描述：以结构化 JSON 提供实时 Google 搜索与 Google Maps 结果，响应格式与 SerpApi 的 google 和 google_maps 引擎一致，块名与字段名相同。
• 兼容性：已有解析 SerpApi 响应的代码可无需修改地使用。
• 指标：9.1 Popularity，82% Service Level，6787ms Latency，100% Test。
• 订阅计划：BASIC $0.00，PRO $15.00。

端点

方法	绝对地址
POST	https://google-serp-search-results-json.p.rapidapi.com/lookup
POST	https://google-serp-search-results-json.p.rapidapi.com/search
GET	https://google-serp-search-results-json.p.rapidapi.com/searchGet
GET	https://google-serp-search-results-json.p.rapidapi.com/maps
GET	https://google-serp-search-results-json.p.rapidapi.com/search.json
GET	https://google-serp-search-results-json.p.rapidapi.com/search.json?engine=google_maps

• https://google-serp-search-results-json.p.rapidapi.com/search.json 是 https://google-serp-search-results-json.p.rapidapi.com/search 的别名。
• POST https://google-serp-search-results-json.p.rapidapi.com/search 支持 JSON 请求体，如 {"query": "pizza", "location": "..."}。
• https://google-serp-search-results-json.p.rapidapi.com/maps 与 https://google-serp-search-results-json.p.rapidapi.com/search.json?engine=google_maps 相同。

Web 搜索参数

参数	必填	说明
q	是	搜索内容，与在 Google 中输入的内容一致。
location	否	搜索来源位置。支持 SerpApi 规范形式（Austin,Texas,United States）或更宽松形式（Austin, TX、Texas、London）。尽力而为。
gl	否	国家两字母代码（us、uk、de、fr、jp 等）。搜索从该国连接运行。默认 us，或 location 的国家。
hl	否	界面语言（en、de、es、pt-BR 等）。默认 en。
start	否	结果偏移分页：10 为第 2 页，20 为第 3 页。默认 0。
num	否	每页结果数（1-100），传给 Google。2025 年起 Google 大多忽略，通常每页约 10 条，建议用 start 分页。
tbs	否	Google 高级过滤器：qdr:h、qdr:d、qdr:w、qdr:m、qdr:y，或日期范围 cdr:1,cd_min:1/1/2026,cd_max:2/1/2026。
safe	否	active 过滤显式结果；off 默认不过滤。
lr	否	仅返回指定语言的页面，如 lang_en、lang_fr。
cr	否	仅返回指定国家的页面，如 countryUS、countryCA。
uule	否	Google 编码位置字符串，原样传递。
device	否	desktop（默认）是当前唯一可用值。
engine	否	google（默认）用于网页搜索，或 google_maps 用于 Google Maps；其他值返回 400。
output	否	json（默认）或 html，后者返回原始 Google 结果页。
resolve	否	true（默认）解析 Google 重定向令牌，使每个 link 为真实目标 URL；false 更快并保留 Google goto 链接。
html	否	true 时还返回原始页面为 search_metadata.html。

响应结构

每个响应包含 search_metadata、search_parameters、search_information，随后是页面实际存在的 result blocks。Google 未显示的块会省略，不返回空。

search_information 包含 Google 显示的查询、结果计数、时间，以及拼写纠正字段：organic_results_state、spelling_fix、showing_results_for。

结果块	内容
organic_results	网页和视频结果：标题、目标 link、Google redirect_link、displayed_link、来源、日期、摘要、高亮词、站内链接、缩略图、视频时长。
ads	顶部和底部文字广告：block_position、标题、link、displayed_link、tracking_link、描述、来源、评分、评论、扩展、站内链接。
local_ads	本地服务广告：标题、see_more_text、link、ads[] 含评分、评论数、类型、服务区域、营业时间、经营年限、高亮详情。
immersive_products	购物卡片：分类、标题、来源、价格、extracted_price、原价、评分、评论、配送、扩展、缩略图、来源 logo、product_id。
local_results	地图包：places[] 含地址、营业时间、电话、网站、评分、评论数、价格等级、类型、GPS 坐标、place_id；另有 more_locations_link。
knowledge_graph	实体面板：标题、类型、描述与来源、kgmid、头图、所有事实、相关列表。
answer_box	weather_result、finance_results、currency_converter、google_flights。
ai_overview	text_blocks[] 与 references[]。
related_questions	“People also ask” 问题。
inline_videos、short_videos	视频轮播：标题、链接、频道/资料、平台、时长、日期、缩略图。
top_stories（+ top_stories_link）	新闻轮播：标题、链接、来源、日期。
perspectives	“What people are saying”：Reddit、YouTube、Instagram、X 等帖子，含作者、来源、点赞/浏览量、日期。
latest_posts	实体自身社交最新帖子，含 likes 与 extracted_likes。
related_searches	建议后续查询及其 Google 搜索链接。
sports_results	团队或联赛面板：标题、排名、games[] 含队伍、比分或开始时间、场地、视频亮点。
events_results	活动与巡演日期：标题、日期、地址或场地、链接、ticket_info。
jobs_results	Google Jobs 框：jobs[] 含标题、company_name、位置、via、扩展、detected_extensions、链接。
recipes_results	食谱卡片：标题、链接、来源、评分、评论、total_time、ingredients。
local_map	本地包旁地图：链接、图片、gps_coordinates。
inline_images	图片条：标题、来源、来源名称、缩略图、原图。
filters	结果上方筛选芯片及其运行的搜索。
refine_this_search	购物搜索中的“Refine this search”建议。
things_to_know	“Things to know” 主题（buttons[]）。
discussions_and_forums	论坛线程（Reddit、Quora 等）：标题、链接、来源、日期、答案。
pagination、serpapi_pagination	分页：current、previous、next、other_pages；pagination 为 Google 链接，serpapi_pagination 为本 API 调用链接。

分页

• 每次调用返回约 10 条结果的一页。
• 第 11-20 位使用 start=10，第 21-30 位使用 start=20，或跟随 serpapi_pagination.next。
• position 每页从 1 开始，总排名为 start + position。

国家、语言和位置

• 搜索从请求国家的住宅连接运行：gl，或 location 的国家，默认 US。
• hl 设置 Google 界面语言。
• 某国暂无连接时，首次搜索较慢，之后搜索较快。
• 使用 location 时，搜索从最接近该地点的可用连接运行，响应中：
  • search_parameters.location_used 表示如何读取 location。
  • search_metadata.served_location 表示实际运行的城市和国家，以及距请求地点的距离。
• 该定位为尽力而为：最近可用连接可能是邻近城市，覆盖较少地区可能更远。若本地准确性重要，检查 served_location.distance_km。
• 无 location 时，搜索为全国范围。

Google Maps（engine=google_maps）

• 以 SerpApi 的 google_maps 格式返回 Google Maps 企业信息。
• 端点：https://google-serp-search-results-json.p.rapidapi.com/maps 或 https://google-serp-search-results-json.p.rapidapi.com/search.json?engine=google_maps。
• 参数：

参数	必填	说明
q	是	查找内容：pizza，或带地点：plumber in denver co。
ll	否	地图位置：@latitude,longitude,zoomz，如 @30.2672,-97.7431,14z，zoom 为 3 到 21。无此参数时，将地点放入 q。
start	否	偏移步长为 20：20 为第 2 页。
hl、gl	否	语言和国家，同网页搜索。
type	否	search（默认）。地点详情（type=place、data_id、place_id）暂不可用。

• 响应包含 search_metadata（含 google_maps_url）、search_parameters、search_information、local_results（每页 20 条），以及可能更多时的 serpapi_pagination.next。
• 每条结果字段：position、title、place_id、data_id、data_cid、gps_coordinates、provider_id、rating、reviews、price、type、types、address、country、open_state、hours、operating_hours、phone、website、description、extensions、unsupported_extensions、order_online、reserve_a_table、book_online、thumbnail。
• 不包含 SerpApi 自身链接：reviews_link、photos_link、place_id_search、serpapi_thumbnail。
• Maps 搜索通常 1-2 秒返回。

时序

• 大多数搜索 1-5 秒返回。
• 需启动新连接的搜索最多约 70 秒，客户端超时至少设为 100 秒。
• search_metadata.total_time_taken 报告每次请求耗时。

错误

状态码	含义
400	缺少 q、不支持的 engine 或 Maps type、错误 ll、无法定位的 location，或错误 gl、hl、start、num。error 字段说明具体原因。
502	重试后仍无法访问 Google（罕见），可安全重试。
503	当前排队搜索过多，按 Retry-After 秒后重试。
504	搜索未及时完成，重试，通常为一次性。

错误为 JSON：{"error": "..."}。

从 SerpApi 迁移

• 更改主机为 https://google-serp-search-results-json.p.rapidapi.com，发送 RapidAPI key，保留解析代码。
• 示例：
  • https://serpapi.com/search.json?engine=google&q=pizza&location=Austin,Texas,United+States&api_key=...
  • https://google-serp-search-results-json.p.rapidapi.com/search.json?engine=google&q=pizza&location=Austin,Texas,United+States
• 差异：
  • 引擎：Google 网页搜索（engine=google）和 Google Maps 搜索（engine=google_maps，type=search）。网页搜索始终在 google.com 上，忽略 google_domain，用 gl 指定国家。
  • 仅桌面结果；device=mobile 或 tablet 返回 400。
  • nfpr=1 和 filter=0 目前返回 400。search_information.showing_results_for 提示 Google 何时更正查询。
  • total_results 是 Google 自己的粗略计数，目前通常约为 100。
  • 尚未解析：图表数据（每小时天气、价格历史），以及 AI Overview 中 Google 仅在“Show more”后加载的部分。
  • Google 内嵌图片（多数 favicon、部分缩略图）被省略，而非重新托管。

其他说明

• 不与 Google LLC 或 SerpApi, LLC 关联。
• 位置数据：IP Geolocation by DB-IP。