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
curl --request POST \
--url https://open.bigmodel.cn/api/paas/v4/web_search \
--header "Authorization: Bearer $ZHIPU_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"search_query": "OpenClaw framework",
"search_engine": "search_pro_quark",
"search_intent": false,
"count": 20
}'
Script Usage
A wrapper shell script is provided for convenience.
# Basic Search (defaults to search_pro_quark and 20 results)
bash scripts/zhipu_search.sh --query "AI development trends"
# Advanced Search
bash scripts/zhipu_search.sh \
--query "latest open source LLMs" \
--engine "search_pro_sogou" \
--count 50 \
--intent \
--recency "oneWeek"
API Parameter Reference
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
search_query | string | ✅ | - | Search content, recommended ≤70 chars |
search_engine | 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 |
|---|---|
search_pro_quark | Quark search, tailored for specific advanced scenarios (Default) |
search_std | 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.
{
"id": "task-id",
"created": 1704067200,
"request_id": "request-id",
"search_intent": [
{
"query": "original query",
"intent": "SEARCH_ALL",
"keywords": "rewritten keywords"
}
],
"search_result": [
{
"title": "title",
"content": "content summary",
"link": "result link",
"media": "site name",
"icon": "site icon",
"refer": "reference number",
"publish_date": "publish date"
}
]
}
Environment Requirements
- Environment variable
ZHIPU_API_KEYmust be configured. curlcommand must be available in your system path.