---
title: "网络搜索"
method: POST
path: "/paas/v4/web_search"
tags: ["工具 API"]
---

# 网络搜索

`POST /paas/v4/web_search`

`Web Search API` 是一个专给大模型用的搜索引擎，在传统搜索引擎网页读取、排序的能力基础上，增强了意图识别能力，返回更适合大模型处理的结果（网页标题、`URL`、摘要、名称、图标等）。支持意图增强检索、结构化输出和多引擎支持。见 [网络搜索服务](/cn/guide/tools/web-search)。点击 **Try it** 按钮可快速试用。

## Request body

- WebSearchRequest
  - `search_query` string, required — 需要进行搜索的内容，建议搜索 `query` 不超过 `70` 个字符。
  - `search_engine` 'search_std' | 'search_pro' | 'search_pro_sogou' | 'search_pro_quark', required — 要调用的搜索引擎编码。目前支持： `search_std`：智谱基础版搜索引擎 `search_pro`：智谱高阶版搜索引擎 `search_pro_sogou`：搜狗 `search_pro_quark`：夸克搜索
  - `search_intent` boolean, required — 是否进行搜索意图识别，默认不执行搜索意图识别。 `true`：执行搜索意图识别，有搜索意图后执行搜索 `false`：跳过搜索意图识别，直接执行搜索
  - `count` integer — 返回结果的条数。可填范围：`1-50`，最大单次搜索返回`50`条，默认为`10`。 支持的搜索引擎：`search_pro_sogou`、`search_std`、`search_pro` `search_pro_sogou`: 可选枚举值，10、20、30、40、50。注意同时指定 search_domain_filter 和 search_recency_filter 时 count 不生效。
  - `search_domain_filter` string — 用于限定搜索结果的范围，仅返回指定白名单域名的内容。 白名单域名:（如 `www.example.com`） 支持的搜索引擎：`search_std、search_pro 、search_pro_sogou`
  - `search_recency_filter` 'oneDay' | 'oneWeek' | 'oneMonth' | 'oneYear' | 'noLimit' — 搜索指定时间范围内的网页。默认为 `noLimit`。可填值：`oneDay`（一天内）、`oneWeek`（一周内）、`oneMonth`（一个月内）、`oneYear`（一年内）、`noLimit`（不限，默认）。支持的搜索引擎：`search_std、search_pro、search_pro_Sogou、search_pro_quark`
  - `content_size` 'medium' | 'high' — 控制返回网页内容的长短。`medium`：返回摘要信息，满足大模型的基础推理需求，满足常规问答任务的信息检索需求。`high`：最大化上下文，信息量较大但内容详细，适合需要信息细节的场景。支持的搜索引擎：`search_std、search_pro、search_pro_Sogou、search_pro_quark`
  - `request_id` string — 请求唯一标识符。由用户端传递，`ID`长度要求：最少`6`个字符，最多`64`个字符，建议使用`UUID`格式确保唯一性，若未提供平台将自动生成。
  - `user_id` string — 终端用户的唯一`ID`，帮助平台对终端用户的非法活动、生成非法不当信息或其他滥用行为进行干预。`ID`长度要求：至少`6`个字符，最多`128`个字符。

## Response `200`

业务处理成功

- WebSearchResponse
  - `id` string — 任务 ID
  - `created` integer — 请求创建时间，是以秒为单位的 `Unix` 时间戳
  - `request_id` string — 请求标识符
  - `search_intent` object[] — 搜索意图结果
    - `query` string — 原始搜索query
    - `intent` 'SEARCH_ALL' | 'SEARCH_NONE' | 'SEARCH_ALWAYS' — 识别的意图类型。`SEARCH_ALL` = 搜索全网，`SEARCH_NONE` = 无搜索意图，`SEARCH_ALWAYS` = 强制搜索模式：当`search_intent=false`时返回此值
    - `keywords` string — 改写后的搜索关键词
  - `search_result` object[] — 搜索结果
    - `title` string — 标题
    - `content` string — 内容摘要
    - `link` string — 结果链接
    - `media` string — 网站名称
    - `icon` string — 网站图标
    - `refer` string — 角标序号
    - `publish_date` string — 网站发布时间

## Other responses

- `default` — 请求失败。可能的错误码：1701-网络搜索并发已达上限，请稍后重试或减少并发请求；1702-系统未找到可用的搜索引擎服务，请检查配置或联系管理员；1703-搜索引擎未返回有效数据，请调整查询条件。

---

[API](https://skmtc.net/bigmodel/apis/zhipu-ai-api.md) · [All operations](https://skmtc.net/bigmodel/apis/zhipu-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigmodel/zhipu-ai-api/revisions/37de2d7b73de/schema)