按任务切换搜索类型
同一入口可在网页、图片、新闻、视频、地点和地图之间切换，无需把所有任务都交给普通网页搜索。查企业资料可用 search，找报道可用 news，发现本地商家可用 places，让输入目标与结果类别更贴合。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 调用方式
- POST /serp/google；Bearer Token 鉴权；JSON 请求与响应
- 查询输入
- query 必填，1—2048 字符，不能全部为空白
- 搜索类型
- search、images、news、maps、places、videos；默认 search
- 分页与数量
- page：1—100，默认 1；number：1—100，默认 10
- 检索控制
- country、language；range 支持过去小时、天、周、月、年
- 图片筛选
- images 模式可用 image_size，如 large、medium、icon、2mp、4mp
- 结果结构
- 分类列表可含标题、链接、摘要、位置；可附相关问题、答案框与知识图谱
以上为 serp 搜索入口的调用规格，不属于生成模型的上下文或输出容量；实际结果条数与附加信息随查询而变化。
核心能力
了解 serp 能为你的工作带来什么。
保留可处理的结果结构
搜索结果以 JSON 返回，便于提取标题、链接、摘要和排序位置，并继续进行去重、展示或存储。普通搜索还可能带回相关问题、相关搜索及知识图谱，帮助应用扩展查询方向，而不是只得到一段难以拆分的文本。
组合地区与时间条件
通过 country、language 和 range，可以围绕目标市场及时间窗口组织检索。例如为同一品牌分别设置国家和语言，再查询过去一天或一周的信息。page 与 number 则用于控制分页及请求数量，便于按任务规模采集结果。
适用场景
从具体任务出发，找到模型发挥作用的位置。
关键词与竞品观察
输入品牌词、产品词或行业关键词，保存网页结果中的标题、链接与位置，形成可供比较的搜索记录。定期查询时保持地区、语言及分页条件一致，可辅助观察竞品页面和关键词表现；记录与比较逻辑由应用自行组织。
新闻线索整理
以企业名称或事件主题作为 query，选择 news 并设置时间范围，整理返回的标题、摘要、链接及可用日期，形成报道线索列表。适合编辑选题和品牌信息观察，后续仍需打开原文核实细节，不把短摘要直接当作完整报道。
AI 助手资料发现
让助手先把用户问题转成查询，再将搜索结果交给语言模型进行归纳和引用整理。支持 MCP 的客户端也可通过 SerpMCP 使用分类搜索工具。serp 负责发现信息与返回链接，最终回答、网页阅读和多步执行由助手流程完成。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
需要检索素材时选择 serp
如果任务需要互联网链接、搜索摘要、结果位置或相关查询，serp 比单纯让生成模型凭已有知识作答更贴合。若交付物是长文、解释或综合分析，可先用 serp 获取素材，再交给语言模型处理；它本身不承担文章生成，也不会自动阅读所有命中网页。
按结果类别选择，而非按代际选择
serp 的选择重点是搜索模式，不是生成模型的版本升级。一般资料发现用 search，近期报道用 news，图片和视频发现分别用 images、videos，本地业务用 places 或 maps。直接 API 适合嵌入程序，MCP 适合由兼容客户端调用，二者不代表不同模型代际。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 搜索返回的是结果条目和可用摘要，不等于目标网页全文，也不等于视频转录或图片内容分析。answer_box、knowledge_graph 等附加对象不保证每次出现，程序应允许字段缺失和结果为空。
- number 是请求的结果数量，不能视为每次必定返回对应条数。分页也不适合当作完整覆盖互联网内容的保证；比较关键词表现时，应保留查询条件，避免把不同地区、语言或时间窗口的结果直接混为一组。
- image_size 只能搭配 images，表示图片搜索筛选条件，不是图片生成分辨率。country 与 language 用于调整检索偏好，不应据此假定每条结果都来自指定国家，或正文都使用同一种语言。
常见问题
解答使用 serp 时的常见疑问。
serp 是 Google 的对话模型吗？
不是。serp 是 Google 搜索结果服务，输入查询后返回结构化搜索数据，而非生成式对话。它适合查找网页、新闻或其他资源；需要解释、写作和综合判断时，可将检索结果交给语言模型继续处理。
最简单的 serp 请求需要哪些内容？
向 /serp/google 发送 POST 请求，使用 Bearer Token，并在 JSON 请求体中提供 query 即可，不需要 model。默认类型是 search，页码为 1、请求数量为 10；查询不能只有空白字符，也不要添加未定义参数。
如何检索过去一天的新闻？
将 type 设为 news，query 填写事件或品牌关键词，range 使用 d 或 qdr:d。需要面向特定市场时，可再设置 country 与 language。返回内容用于发现近期报道，具体发布时间与事件细节仍应结合原文确认。
图片搜索能指定生成尺寸吗？
不能，serp 搜索已有图片，不生成新图片。type 为 images 时，可用 image_size 设置 large、medium、icon 或支持的 mp 筛选档位；其他搜索类型不能携带该字段。结果中的图片链接也不代表已获得使用授权。
拿到搜索结果后会自动打开网页吗？
不会因一次搜索请求就自动完成网页阅读或多步研究。serp 返回链接、摘要及可用的附加信息，应用可据此选择后续阅读对象。通过 MCP 使用时，搜索只是助手的一项工具，完整任务仍由客户端组织执行。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。