Google Search API

Search Google web and image results with fast requests, paging, language options, and selected output fields.

原始信息汇总

Google Search API 数据集概述

基本信息

• 数据集地址：https://rapidapi.com/mholdb/api/google-search-api50
• API 版本：v1（当前版本）
• 分类：Search APIs
• API 创建者：Minh Quy Truong
• 订阅者数量：1
• 性能指标：
  • 流行度：8.7
  • 服务等级：100%
  • 延迟：1058ms
  • 测试：N/A

功能概述

通过单次请求查询 Google 网页和图片搜索结果，返回标题、URL、描述、图片数据、可选的知识图谱实体及选定字段。支持国家和语言选项，每页最多请求 10 条结果，最多可收集前 100 个结果位置。

接口信息

• 接口路径：POST /search
• 请求头：

Header	Value
Content-Type	application/json
X-RapidAPI-Key	你的 RapidAPI 密钥
X-RapidAPI-Host	Endpoints 页面显示的 host

• 请求体示例：

json { "q": "OpenAI", "num": 10, "knowledgeGraphLimit": 0, "searchType": "web" }

输入参数

字段	类型	必填	说明
q	string	是	搜索查询，至少一个字符。
num	integer	否	未使用 maxResults 时的最大结果数，1 到 10，默认 10。
start	integer	否	起始结果位置，1 到 91，默认 1。与 num 和 maxResults 配合使用。
gl	string	否	两位国家代码，如 us 或 gb。
hl	string	否	首选界面语言代码，2 到 5 个字符，如 en 或 fr。
sort	string	否	排序表达式，date 表示按日期请求结果。
searchType	string	否	web 或 image，默认 web。
maxResults	integer	否	跨页收集的最大总结果数，至少为 1，覆盖 num 并保留 start。
knowledgeGraphLimit	integer	否	最大相关实体数，0 到 20，默认 5，设为 0 可禁用。
fields	string[]	否	每条结果包含的字段，省略或发送空数组使用默认字段，["*"] 表示所有可用字段。

结果限制与分页

• 仅前 100 个结果位置可用。
• 响应结果可能少于请求数量。
• num 控制小请求的结果上限；maxResults 在必要时跨页收集结果，可能增加响应时间。两者同时存在时使用 maxResults，均从 start 开始。
• 手动分页时，将 start 设为上一次响应的 nextStart，仅当其大于上一次 start 且不大于 91 时继续，若缺失、重复或响应为 resultCount: 0 则停止。
• nextPage 是页面标签；pageNumber 按每 10 个结果位置分组。
• totalResults 是所有匹配项的估算值，可能远大于实际可用结果数。

结果字段

默认字段：position、type、title、url、displayUrl、siteName、description。

字段	内容
position	结果位置，从 1 开始。
type	web 或 image。
title	结果标题。
url	结果 URL，图片结果中为图片 URL。
description	文本描述。
htmlDescription	带 HTML 格式的描述。
siteName	站点域名。
displayUrl	用于显示的格式化 URL。
thumbnail	可用时的缩略图 URL。
cacheId	可用时的缓存标识。
mime	可用时的 MIME 类型。
fileFormat	可用时的文件格式。
imageWidth	图片宽度（像素）。
imageHeight	图片高度（像素）。
imageByteSize	图片大小（字节）。
pagemap	附加页面元数据。
labels	结果标签，包含 name、displayName、labelWithOp。

图片字段需设置 searchType: "image" 及相应字段名，或使用 ["*"]。请求的字段在无值时可能缺失。fields 不能选择页面字段、拼写建议或知识图谱字段。

响应结构

成功请求返回 HTTP 201 及包含 data 和 meta 的 JSON 对象。

字段	类型	内容
data.pageNumber	integer	初始结果位置的页面标签。
data.searchTerm	string	输入查询。
data.totalResults	string	估算的总匹配数。
data.searchTime	number	首页报告的搜索时间（秒），非总请求时长。
data.resultCount	integer	返回结果数量。
data.results	object[]	含所选字段的搜索结果。
data.spellCheck.correctedQuery	string	可用时的查询拼写建议。
data.knowledgeGraph	object[]	请求且可用时的相关实体。
data.nextPage	integer	可用时的下一页标签。
data.nextStart	integer	可用时的建议下一结果位置。
meta.tool	string	google-search。
meta.creditsUsed	number	后端信用成本：0.5。
meta.requestId	string	用于支持请求的请求标识。

缺失值和空数组/对象将被省略。使用 data.resultCount 检查是否无结果，为 0 时 data.results 可能缺失。

知识图谱实体可包含 name、description、type、url，还可包含带 articleBody、url、license 的 detailedDescription，以及带 url、contentUrl 的 image。该数据为可选，实体搜索无结果或不可用时主搜索仍可成功。

订阅计划

计划	月费	每月请求数
Basic	免费	25
Pro	$4.99	20,000
Ultra	$24.99	120,000
Mega	$99	500,000

• 每个计划有硬性请求限制。
• 每个计划每月包含 10,240 MB 带宽，额外带宽为 $0.001/MB。
• 推荐使用 Pro 计划。
• 每次网关调用消耗 1 个 RapidAPI Requests 单位，包括跨页收集结果的调用。meta.creditsUsed: 0.5 为独立的后端元数据，不影响 RapidAPI 请求计数。

错误码

HTTP 状态码	含义
400	输入缺失或无效。
401	认证失败。
402	服务账户无有效订阅或可用信用。
403	请求不被允许。
429	达到请求、速率、并发或容量限制。
500、502、503、504	服务错误或时间限制导致未完成。

后端错误包含 type、status、code、message、requestId、docUrl、retryable。validation_error 需更改输入。retryable 为 true 时应等待后重试，存在 Retry-After 时遵循该值。联系支持时保留请求 ID。RapidAPI 可能针对网关认证或计划限制返回不同的错误体。