> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pipellm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速搜索

> 通过 PipeLLM WebSearch 获取更快的搜索摘要结果

当你只想更快拿到搜索结果，而不需要页面抽取、向量检索和重排序时，使用这条路由。

## Endpoint

| 方法    | 端点                                                  |
| ----- | --------------------------------------------------- |
| `GET` | `https://api.pipellm.ai/v1/websearch/simple-search` |

## 认证

```text theme={null}
Authorization: Bearer $PIPELLM_API_KEY
```

## 查询参数

| 参数  | 类型     | 必填 | 描述    |
| --- | ------ | -- | ----- |
| `q` | string | 是  | 搜索关键词 |

## 请求示例

```bash theme={null}
curl -X GET "https://api.pipellm.ai/v1/websearch/simple-search?q=最新AI新闻" \
  -H "Authorization: Bearer $PIPELLM_API_KEY"
```

## 响应结构

```json theme={null}
{
  "code": 200,
  "message": "ok",
  "took_ms": 950,
  "data": {
    "answerBox": {
      "title": "Latest AI news",
      "snippet": "..."
    },
    "organic": [
      {
        "title": "AI News",
        "link": "https://example.com",
        "snippet": "Latest updates..."
      }
    ]
  }
}
```

## 说明

* 这条路由代理到内部 `/api/simple-search`。
* 它会更快返回结果，但不会通过深度检索补充 `contexts`。
* 每次成功请求价格为 \$0.01，并以内部模型名 `websearch` 记录。
* PipeLLM 会根据路由自动确定模型名，客户端不需要传入。

## 相关文档

<Columns cols={3}>
  <Card title="深度搜索" icon="magnifying-glass" href="/websearch/search-api.zh">
    需要更丰富上下文时，使用检索和重排序
  </Card>

  <Card title="新闻搜索" icon="newspaper" href="/websearch/news-search.zh">
    搜索近期新闻，而不是通用网页结果
  </Card>

  <Card title="WebSearch 总览" icon="globe" href="/websearch/overview.zh">
    查看产品总览和完整路由矩阵
  </Card>
</Columns>