| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
search_metadata | object | 搜索请求元数据 | 见下方 | 是 |
spider_parameter | object | 请求参数(引擎、 查询、设备等) | 见下方 | 是 |
text_blocks | array | 搜索结果的内容块列表,按顺序渲染 | 见下方 | 是 |
| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
id | string | 本次搜索唯一标识 | "51HYJURE5LTZ1784538982" | 是 |
spider_url | string | 实际请求的 Google 搜索 URL | "https://www.google.com/search?q=pizza&udm=50..." | 是 |
total_time_taken | float | 总耗时(秒) | 10.5857 | 是 |
created_at | string | 请求创建时间 | "2026-07-20 17:16:22" | 是 |
processed_at | string | 处理完成时间 | "2026-07-20 17:16:32" | 是 |
status | string | 请求状态 | "Success" | 是 |
| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
engine | string | 搜索引擎及模式 | "google_ai_mode" | 是 |
domain | string | 搜索域名 | "https://www.google.com/" | 是 |
q | string | 查询关键词 | "pizza" | 是 |
render_js | boolean | 是否渲染 JavaScript | false | 是 |
render_png | boolean | 是否生成页面截图 | false | 否 |
device | string | 设备类型 | "desktop" | 是 |
ai_overview | boolean | 是否启用 AI 概览(传统模块) | false | 是 |
type 不同,包含不同的字段。| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
type | string | 内容块类型,当前支持 heading、list | "heading" | 是 |
snippet | string | 当 type 为 heading 时,表示标题文本 | "Top Chicago Pizza Restaurants (July 2026)" | 条件必返(type=heading) |
list | array | 当 type 为 list 时,表示列表条目数组 | 见下方 | 条件必返(type=list) |
| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
snippet | string | 列表项文本内容,可能包含商家名、地址、推荐语等;若含来源链接见 snippet_links 字段 | "Spacca Napoli: Top pick for Neapolitan-style pizza." | 是 |
snippet_links | array | 与该项关联的参考链接列表(可选) | 见下方 | 否 |
| 字段名 | 数据类型 | 说明 | 示例 | 是否必返 |
|---|---|---|---|---|
title | string | 链接标题(如网站名称) | "Home Run Inn" | 否 |
link | string | 目标 URL | "https://www.homeruninnpizza.com/" | 是 |
source | string | 来源域名或来源标识 | "www.homeruninnpizza.com" | 是 |