---
title: "联网搜索接口"
method: POST
path: "/web_search"
tags: ["WebSearch"]
---

# 联网搜索接口

`POST /web_search`

在传统搜索引擎网页抓取、排序的能力基础上，增强了意图识别能力，返回更适合大模型处理的结果（网页标题、URL、摘要、名称、图标等）。

## Request body

- object
  - `model` string, required — 搜索模型
  - `prompt` string, required — 搜索提示
  - `intent` boolean — 是否开启意图识别，默认为false
  - `count` integer — 返回结果数量，默认10，最大50
  - `domain_filter` string — 域名过滤器，逗号分隔的域名列表，搜索结果将只包含这些域名的内容
  - `recency_filter` 'noLimit' | 'oneDay' | 'oneWeek' | 'oneMonth' | 'oneYear' — 搜索指定时间范围内的网页，可选值为 noLimit（默认值，不限时间）, oneDay（一天内）, oneWeek（一周内）, oneMonth（一月内）, oneYear（一年内）
  - `content_size` 'medium' | 'high' — 控制返回网页摘要内容的长短，可选值为 medium（中等摘要，满足常规问答任务，默认值）, high（详细摘要，最大化上下文，适合需要细节支撑的场景）

## Response `200`

成功响应

- object
  - `id` string, required — 请求ID
  - `created` integer, required — 请求创建时间戳
  - `results` object[], required — 搜索结果列表
    - `link` string, required — 网页链接
    - `title` string, required — 网页标题
    - `content` string, required — 内容摘要
    - `icon` string — 网站图标
    - `media` string — 网站名称

## Other responses

- `400` — 参数验证错误
- `401` — 未授权
- `500` — 标准错误响应

---

[API](https://skmtc.dev/geekai/apis/api.md) · [All operations](https://skmtc.dev/geekai/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/geekai/api/revisions/2bf0c8f70a39/schema)