---
title: "POST /paas/v4/web_search"
method: POST
path: "/paas/v4/web_search"
---

# POST /paas/v4/web_search

`POST /paas/v4/web_search`

The [Web Search](/guides/tools/web-search) is a specialized search engine for large language models. Building upon traditional search engine capabilities like web crawling and ranking, it enhances intent recognition to return results better suited for LLM processing (including webpage titles, URLs, summaries, site names, favicons etc.).

## Headers

- `Accept-Language` 'en-US,en' — Config desired response language for HTTP requests.

## Request body

- WebSearchRequest
  - `search_engine` 'search-prime', required — The search engine code to call. search-prime: Z.AI Premium Version Search Engine
  - `search_query` string, required — The content to be searched.
  - `count` integer — The number of results to return Fillable range: `1-50`, maximum `50` results per single search Default is `10` Supported search engines: `search_pro_jina`.
  - `search_domain_filter` string — Used to limit the scope of search results and only return content from specified whitelist domains. Whitelist: Directly enter the domain name (e.g., `www.example.com`) Supported search engines: `search_pro_jina`
  - `search_recency_filter` 'oneDay' | 'oneWeek' | 'oneMonth' | 'oneYear' | 'noLimit' — Search for webpages within a specified time range. Default is `noLimit` Fillable values: `oneDay`: within one day `oneWeek`: within one week `oneMonth`: within one month `oneYear`: within one year `noLimit`: no limit (default) Supported search engines: `search_pro_jina`
  - `request_id` string — Passed by the user side, needs to be unique; used to distinguish each request, 6–64 characters. If not provided by the user side, the platform will generate one by default.
  - `user_id` string — Unique ID for the end user, 6–128 characters. Avoid using sensitive information.

## Response `200`

Processing successful

- WebSearchResponse
  - `id` string — Task ID.
  - `created` integer — Request creation time, Unix timestamp in seconds.
  - `search_result` WebSearchObjectResponse[] — Search results.
    - `title` string — Title.
    - `content` string — Content summary.
    - `link` string — Result URL.
    - `media` string — Website name.
    - `icon` string — Website icon.
    - `refer` string — Index number.
    - `publish_date` string — Website publication date.

## Other responses

- `default` — The request has failed.

---

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