Zhipu Web Search
Web search via Zhipu AI's dedicated API (/paas/v4/web_search), refactored to use lightweight cURL instead of Python or jq. It defaults to using the search_pro_quark engine with 20 results.
Quick Start
Basic cURL Usage
CODEBLOCK0
Script Usage
A wrapper shell script is provided for convenience.
CODEBLOCK1
API Parameter Reference
| Parameter | Type | Required | Default | Description |
|---|
| INLINECODE4 | string | ✅ | - | Search content, recommended ≤70 chars |
| INLINECODE5 |
enum | ✅ |
search_pro_quark |
search_std /
search_pro /
search_pro_sogou /
search_pro_quark |
|
search_intent | boolean | - |
false | Enable search intent recognition |
|
count | integer | - |
20 | Result count, range 1-50 |
|
search_domain_filter | string | - | - | Whitelist domain filter |
|
search_recency_filter | enum | - |
noLimit |
oneDay /
oneWeek /
oneMonth /
oneYear /
noLimit |
|
content_size | enum | - |
medium |
medium (summary) /
high (detailed) |
Search Engine Selection Guide
| Engine | Use Case |
|---|
| INLINECODE27 | Quark search, tailored for specific advanced scenarios (Default) |
| INLINECODE28 |
Basic search, regular Q&A |
|
search_pro | Advanced search, need more accurate results |
|
search_pro_sogou | Sogou search, China domestic content |
Response Structure
The API returns JSON directly.
CODEBLOCK2
Environment Requirements
- - Environment variable
ZHIPU_API_KEY must be configured. - INLINECODE32 command must be available in your system path.
智谱网络搜索
通过智谱AI专用API(/paas/v4/websearch)进行网络搜索,已重构为使用轻量级cURL替代Python或jq。默认使用searchpro_quark搜索引擎,返回20条结果。
快速开始
基础cURL用法
bash
curl --request POST \
--url https://open.bigmodel.cn/api/paas/v4/web_search \
--header Authorization: Bearer $ZHIPUAPIKEY \
--header Content-Type: application/json \
--data {
search_query: OpenClaw框架,
searchengine: searchpro_quark,
search_intent: false,
count: 20
}
脚本用法
提供封装好的Shell脚本以便使用。
bash
基础搜索(默认使用searchproquark,返回20条结果)
bash scripts/zhipu_search.sh --query AI发展趋势
高级搜索
bash scripts/zhipu_search.sh \
--query 最新开源大语言模型 \
--engine search
prosogou \
--count 50 \
--intent \
--recency oneWeek
API参数参考
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
| searchquery | 字符串 | ✅ | - | 搜索内容,建议不超过70个字符 |
| searchengine |
枚举 | ✅ | search
proquark | search
std / searchpro / search
prosogou / search
proquark |
| search_intent | 布尔值 | - | false | 启用搜索意图识别 |
| count | 整数 | - | 20 | 结果数量,范围1-50 |
| search
domainfilter | 字符串 | - | - | 域名白名单过滤 |
| search
recencyfilter | 枚举 | - | noLimit | oneDay / oneWeek / oneMonth / oneYear / noLimit |
| content_size | 枚举 | - | medium | medium(摘要)/ high(详细) |
搜索引擎选择指南
| 引擎 | 使用场景 |
|---|
| searchproquark | 夸克搜索,针对特定高级场景优化(默认) |
| search_std |
基础搜索,常规问答 |
| search_pro | 高级搜索,需要更精确的结果 |
| search
prosogou | 搜狗搜索,国内内容 |
响应结构
API直接返回JSON格式数据。
json
{
id: 任务ID,
created: 1704067200,
request_id: 请求ID,
search_intent: [
{
query: 原始查询,
intent: SEARCH_ALL,
keywords: 重写后的关键词
}
],
search_result: [
{
title: 标题,
content: 内容摘要,
link: 结果链接,
media: 站点名称,
icon: 站点图标,
refer: 引用编号,
publish_date: 发布日期
}
]
}
环境要求
- - 必须配置环境变量ZHIPUAPIKEY。
- 系统中必须存在curl命令。