模板代码:google_search
当前版本: v6
功能简介 #
采集 Google 网页、新闻、图片、图书或视频搜索结果。可按内容类型、国家地区、设备类型和起始页控制搜索。
使用方法:你可以在 Clawoxy 控制台的 Scraping API 模板市场选择本模板并填写参数,也可以在自己的程序中调用 Scraping API。若不确定如何编写代码,可将目标网站链接和本模板说明提供给 AI,请 AI 按模板支持的参数与接口要求生成调用代码。执行前请检查输入参数、API Key 的保护方式及结果解析逻辑。
输入参数 #
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| keyword | string | 是 | 搜索词,1–2048 字符。 |
| content_type | string | 否 | 新闻、图片、图书或视频;默认网页搜索。 |
| country | string | 否 | 两字符国家/地区代码。 |
| device_type | string | 否 | 从可选设备类型中选择。 |
| start_page | integer | 否 | 起始页 1–10,默认 1。 |
输出内容 #
输出包含搜索结果页链接、页码、网页/新闻/图片/视频/图书结果、AI 概览、最后可见页码及预估匹配结果数。字段说明见下表。
输出字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
search_url | string | 本次查询对应的 Google 搜索结果页链接。 |
page | integer | 当前结果对应的搜索页码。 |
organic_results | array<object> | 自然搜索结果列表。每项包含结果链接、标题、位置、摘要、来源名称、展示 URL、图片数据及综合位置。 |
news_results | array<object> | 新闻结果列表,包含链接、标题、来源、摘要、图片数据、发布时间原文及综合位置。 |
image_results | array<object> | 图片结果列表,包含标题、结果位置、图片链接、图片数据、来源链接、来源域名及综合位置。 |
video_results | array<object> | 视频结果列表,包含视频链接、标题、结果位置、说明及综合位置。 |
book_results | array<object> | 图书结果列表,包含图书链接、标题、结果位置、图片数据、简介、书内匹配文本及相关链接。 |
ai_overviews | array<object> | AI 概览列表。answer_text 保存分段文本及引用;bullet_list 保存列表标题和要点;source_panel 保存来源面板;overall_position 是结果位置。 |
last_visible_page | integer | 搜索结果中最后可见的页码;后台说明无法确定时可能为 -1。 |
total_results_count | integer | 搜索引擎提供的预估匹配结果总数。 |
示例返回 #
空值和 0 为字段结构占位,不是真实搜索结果。
{
"page": 0,
"search_url": "",
"ai_overviews": [
{
"answer_text": [
{ "pos": 0, "fragments": [{ "text": "", "references": [{ "url": "", "source": "" }] }] }
],
"bullet_list": [
{ "pos": 0, "points": [{ "text": "", "references": [{ "url": "", "source": "" }] }], "list_title": "" }
],
"source_panel": {},
"overall_position": 0
}
],
"book_results": [
{ "url": "", "links": [{ "url": "", "title": "" }], "title": "", "position": 0, "image_data": "", "description": "", "found_inside_text": "" }
],
"news_results": [
{ "url": "", "title": "", "source": "", "image_data": "", "description": "", "overall_position": 0, "published_at_text": "" }
],
"image_results": [
{ "title": "", "position": 0, "image_url": "", "image_data": "", "source_url": "", "source_domain": "", "overall_position": 0 }
],
"video_results": [
{ "url": "", "title": "", "position": 0, "description": "", "overall_position": 0 }
],
"organic_results": [
{ "url": "", "title": "", "position": 0, "image_data": [""], "description": "", "source_name": "", "displayed_url": "", "overall_position": 0 }
],
"last_visible_page": 0,
"total_results_count": 0
}
采集结果保留 3 天。