# Felo 网页搜索

POST /api/v1/data/web/search

搜索网页，获取可供应用进一步处理的来源列表。需要生成带来源的回答时，请使用[联网问答](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-chat.md)。

示例使用[总览](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-overview.md)中配置的 `FELO_API_KEY`。调用使用**平台余额**，不使用 Felo Pro 积分。响应示例仅展示结构，实际内容和可选字段会变化。

## 接口

`POST /api/v1/data/web/search`

## 请求参数

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `query` | string | 是 | 搜索词，1–4,000 字符 |
| `count` | integer | 否 | 期望结果数量，1–50；默认 10 |

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/web/search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"检索增强生成 RAG","count":3}'
```

## 返回结果

HTTP 200，结果直接位于 JSON 根层级：

```json
{
  "resources": [
    {"title":"示例指南","link":"https://example.com/guide","snippet":"介绍检索增强生成的基本原理。"}
  ],
  "total": 1
}
```

| 字段 | 说明 |
|---|---|
| `resources` | 返回的网页，每项包含 `title`、`link` 和 `snippet` |
| `total` | 本次返回的资源数量，不是互联网中所有匹配网页的数量 |

`count` 是期望数量，不保证一定返回这么多结果。此接口没有游标分页参数。需要获取来源全文时，把 `link` 交给[网页读取](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-web-read.md)。

## 计费与失败处理

计费单位是一次请求（`web.search`），不是每个返回的网页。单价见[当前价格表](https://openapi.felo.ai/api/v1/data/prices)。余额或配额错误与成功但无结果是不同情况，处理规则见[计费与错误处理](https://openapi.felo.ai/zh-CN/docs/data-api/guides/felo-billing.md)。