Google Site Search API
查询指定域名的 Google 估算结果数量和当前自然搜索结果，并可选限定时间范围。
接口地址
GET https://api.goanyapi.com/api/v1/google-site-search当前配置下，每次成功请求消耗 4 积分。
当前请求价格以本页显示的 API 配置为准。
鉴权
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
site | 是 | 要查询的域名，例如 example.com 或 www.example.com，最长 253 个字符。不得包含协议、端口、路径或 site: 前缀。 |
qdr | 否 | 可选时间范围：h、d、w、m 或 y；不传即为不限时间。 |
gl | 否 | 两位国家代码，例如 us。 |
hl | 否 | 两位界面语言代码，例如 en。 |
device | 否 | desktop、mobile、ios、iphone、ipad、ios_tablet、android 或 android_tablet。 |
browser | 否 | chrome、safari 或 firefox；Firefox 只能与桌面设备搭配。 |
safe | 否 | 安全搜索设置：active 或 off。 |
接口不接受原始 q、tbs、search_type、tbm 或 udm 参数。
请求示例
curl --get 'https://goanyapi.com/api/v1/google-site-search' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-urlencode 'site=example.com' \
--data-urlencode 'qdr=w'该请求会应用以下搜索范围：
site:example.com本例传入 qdr=w，把查询限定到最近一周。
响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "google-site-search",
"remainingCredits": 96,
"query": {
"site": "example.com",
"qdr": "w"
},
"siteCount": 128000,
"searchTime": 0.42,
"organic": [
{
"link": "https://example.com/article",
"source": "Example",
"display_link": "https://example.com › article",
"title": "Example Article",
"description": "示例搜索结果。",
"extensions": [
{
"inline": true,
"type": "text",
"text": "3 days ago",
"rank": 1
}
],
"rank": 1,
"global_rank": 1
}
]
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 接口标识：google-site-search。 |
data.costCredits | 本次成功请求消耗的积分。 |
data.remainingCredits | 请求后的剩余积分。 |
data.query | 规范化后的公开请求参数。 |
data.siteCount | 完整网站查询报告的估算结果总数。 |
data.searchTime | 搜索处理时间（如果存在）。 |
data.organic | 当前结果页返回的自然搜索结果。 |
data.organic[].extensions | 可选的结果扩展信息；设置时间范围后，部分结果可能包含相对时间提示。 |
siteCount 是估算值，不是准确收录量，也不是 organic 的条目数量，并且可能随时间、国家、语言、设备和浏览器变化。
当请求设置 qdr 时间范围时，部分自然结果可能在 extensions 中返回类似 3 days ago 的时间提示，可作为页面近期被发现或收录的参考。该字段不是必返字段，并非每条结果都会出现，也不应视为精确的抓取时间或首次收录时间。
计费
- 只有查询成功返回有效的
siteCount后才扣除积分。 - 鉴权失败、参数错误、查询失败和结果不完整均不扣积分。