# Tìm kiếm Web Felo

POST /api/v1/data/web/search

Tìm kiếm web và nhận các trang nguồn để ứng dụng của bạn xử lý. Để có câu trả lời được tạo kèm nguồn, hãy dùng [Chat](https://openapi.felo.ai/vi/docs/data-api/guides/felo-chat.md).

Tất cả ví dụ dùng `FELO_API_KEY` từ [tổng quan](https://openapi.felo.ai/vi/docs/data-api/guides/felo-overview.md). Các cuộc gọi sử dụng **số dư nền tảng**, không phải tín dụng Felo Pro. Các ví dụ phản hồi chỉ mang tính minh họa; nội dung thực tế và các trường tùy chọn sẽ thay đổi.

## Endpoint

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

## Yêu cầu

| Trường | Kiểu | Bắt buộc | Ý nghĩa |
|---|---|---|---|
| `query` | string | Có | Câu truy vấn tìm kiếm, 1–4.000 ký tự |
| `count` | integer | Không | Số lượng kết quả yêu cầu, 1–50; mặc định 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":"retrieval augmented generation","count":3}'
```

## Phản hồi

HTTP 200 trả về các kết quả ở gốc JSON:

```json
{
  "resources": [
    {"title":"Example guide","link":"https://example.com/guide","snippet":"An introduction to retrieval augmented generation."}
  ],
  "total": 1
}
```

| Trường | Ý nghĩa |
|---|---|
| `resources` | Các trang được trả về; mỗi trang có `title`, `link` và `snippet` |
| `total` | Số lượng tài nguyên được trả về, không phải tổng số trang trên internet |

`count` là số lượng được yêu cầu, không phải là bảo đảm sẽ có đủ kết quả phù hợp. Endpoint này không có tham số con trỏ. Để đọc đầy đủ một nguồn, hãy truyền `link` của nó sang [Đọc Web](https://openapi.felo.ai/vi/docs/data-api/guides/felo-web-read.md).

## Thanh toán và lỗi

Đơn vị tính phí là một yêu cầu (`web.search`), không phải một trang được trả về. Đọc [giá hiện tại](https://openapi.felo.ai/api/v1/data/prices). Lỗi số dư hoặc hạn mức phải được xử lý riêng với một kết quả thành công nhưng rỗng; xem [Thanh toán và Lỗi](https://openapi.felo.ai/vi/docs/data-api/guides/felo-billing.md).