Google 自动补全接口，返回搜索建议及相关地区/语言参数。

本页给出 Google 自动补全搜索 的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Google 自动补全搜索
原始名称	Google Autocomplete Search
内部标识（scraper）	google_autocomplete
接口标识（engine）	google_autocomplete_search
网站	Google
网站地址	googleautocomplete.com
输出格式	json
版本	1.0.0
参数数量	4
参数分组	搜索词 (1), 地区与语言 (2), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_autocomplete 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_autocomplete","q":"open"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "created_at": "2026-03-26 08:33:44 UTC",
    "id": "01KMMMEB039C8Q8BP1X3AESH47",
    "json_endpoint": "https://serp.xcrawl.com/01KMMMEB039C8Q8BP1X3AESH47.json",
    "processed_at": "2026-03-26 08:33:44 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMMEB039C8Q8BP1X3AESH47.html",
    "status": "completed",
    "total_time_taken": 2
  },
  "search_parameters": {
    "engine": "google_autocomplete",
    "q": "open"
  },
  "total_credits_used": 1,
  "suggestions": [
    {
      "link": "https://www.google.com/search?q=openclash",
      "relevance": 700,
      "type": "QUERY",
      "value": "openclash"
    },
    {
      "_note": "14 more items omitted"
    }
  ]
}

必填参数

以下表格列出当前 metadata 中标记为 must: true 的字段。字段是否必填，以 properties.<field>.must 为准，不以顶层 required 数组为准。

参数	类型	分组	说明
q	string	搜索词	你想让搜索引擎检索的关键词或短语。

可用参数

以下内容按后端返回的字段分组展示。主表只保留字段名、类型、必填标记和字段说明；默认值、可选值等附加约束会列在每个分组后。

搜索词

参数	类型	必填	说明
q	string	是	你想让搜索引擎检索的关键词或短语。

地区与语言

参数	类型	必填	说明
gl	string	否	用于本地化搜索结果的国家或地区代码。
hl	string	否	用于控制搜索界面和结果标签语言的参数。

附加约束

• gl：默认值：us；可选值：244 个可选值，例如：af、al、dz、as、ad
• hl：默认值：en；可选值：157 个可选值，例如：af、ak、sq、ws、am

请求控制

参数	类型	必填	说明
no_cache	boolean	否	跳过缓存结果并强制重新抓取。

附加约束

• no_cache：默认值：false

上一页Google Trends 自动补全

下一页Bing 新闻搜索