Google AI Overview 搜索

Google AI Overview SERP，支持基于查询词获取 AI Overview 结果。

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

元数据

字段	值
引擎名称	Google AI Overview 搜索
原始名称	Google Search Ai
内部标识（scraper）	`google_ai_overview`
接口标识（engine）	`google_search_ai`
网站	Google
网站地址	googlesearchai.com
输出格式	`json`
版本	`1.0.0`
参数数量	`2`
参数分组	搜索词 (1), 请求控制 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_ai_overview 的请求。对于 /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_ai_overview","q":"what is machine learning"}'

响应示例

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

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:19:26 UTC",
    "id": "01KMMKKW7QAFBR3KE6HMGTCE4G",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKKW7QAFBR3KE6HMGTCE4G.json",
    "processed_at": "2026-03-26 08:19:26 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKKW7QAFBR3KE6HMGTCE4G.html",
    "status": "completed",
    "total_time_taken": 9
  },
  "search_parameters": {
    "engine": "google_ai_overview",
    "q": "what is machine learning"
  },
  "total_credits_used": 1,
  "ai_overviews": {
    "references": [
      {
        "index": 1,
        "link": "https://www.youtube.com/shorts/TLP33fc1l78",
        "snippet": null,
        "source": "YouTube",
        "title": "What is Machine Learning? Explained for Beginners | AI & Data Science ..."
      },
      {
        "_note": "2 more items omitted"
      }
    ],
    "text_blocks": [
      {
        "snippet": " 'Machine learning (ML) is', 'a branch of artificial intelligence (AI) where computers are trained to identify patterns, make decisions, and generate predictions from data without being explicitly programmed for every sp... [truncated, 451 chars]",
        "type": "paragraph"
      }
    ]
  }
}

必填参数

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

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

可用参数

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

搜索词

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

请求控制

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

附加约束

no_cache：默认值：false

引擎列表

Google AI Overview 搜索