Google Intitle API
查询标题包含完整短语的 Google 估算结果数量和自然搜索结果，并可选限定时间范围。
接口
GET https://api.goanyapi.com/api/v1/google-intitle当前配置下，每次成功请求消耗 4 积分。
当前请求价格以本页显示的 API 配置为准。
鉴权
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
intitle | 是 | 将被封装为 intitle:"短语" 的完整标题短语，最长 180 个字符，不允许双引号和控制字符。 |
qdr | 否 | 可选时间范围：h、d、w、m 或 y；不传时查询不限时间的结果。 |
gl | 否 | Google 两位国家代码，例如 us。 |
hl | 否 | Google 两位界面语言代码，例如 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 参数。
时间范围
不传 qdr 即为“不限时间”。传入时支持：
qdr | Google 筛选范围 |
|---|---|
h | 最近一小时 |
d | 最近一天 |
w | 最近一周 |
m | 最近一个月 |
y | 最近一年 |
请求示例
curl --get 'https://goanyapi.com/api/v1/google-intitle' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-urlencode 'intitle=ai image' \
--data-urlencode 'gl=us' \
--data-urlencode 'hl=en' \
--data-urlencode 'device=desktop' \
--data-urlencode 'browser=chrome' \
--data-urlencode 'safe=off'对应的 Google 查询语义为：
intitle:"ai image"例如额外传入 qdr=y 时，会生成 tbs=qdr:y，将查询限定到最近一年。
响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "google-intitle",
"remainingCredits": 96,
"query": {
"intitle": "ai image",
"gl": "us",
"hl": "en",
"device": "desktop",
"browser": "chrome",
"safe": "off"
},
"intitleCount": 1150000,
"searchTime": 0.5,
"organic": [
{
"link": "https://example.com/ai-image-guide",
"source": "Example",
"display_link": "https://example.com › ai-image-guide",
"title": "AI Image Guide",
"description": "一份实用的 AI 图片生成指南。",
"rank": 1,
"global_rank": 1
}
]
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 接口内部标识：google-intitle。 |
data.costCredits | 本次成功请求消耗的积分。 |
data.remainingCredits | 扣除后的剩余积分。 |
data.query | 规范化后的公开请求参数。 |
data.intitleCount | Google 针对完整筛选查询报告的估算结果总数。 |
data.searchTime | Google 报告的搜索处理时间（如果存在）。 |
data.organic | 当前 Google 结果页返回的自然搜索结果。 |
每个 data.organic[] 条目会保留可用的自然结果字段，包括 link、source、display_link、title、description、snippet_highlighted_words、icon、rank、global_rank 和 extensions。
intitleCount 是 Google 报告的估算值，不是当前页面返回的自然结果条数，并且可能随时间、国家、语言、设备和浏览器变化。
计费
- 只有查询成功返回有效的
intitleCount后才扣除积分。 - 鉴权失败、参数错误、查询失败和结果不完整均不扣积分。