# Carian Web

Cari halaman web dan pulangkan tajuk, pautan dan petikan.

Cari web dan terima halaman sumber untuk diproses oleh aplikasi anda. Untuk jawapan yang dijana dengan sumber, gunakan [Sembang](https://openapi.felo.ai/ms/docs/data-api/guides/felo-chat.md).

Semua contoh menggunakan `FELO_API_KEY` daripada [gambaran keseluruhan](https://openapi.felo.ai/ms/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **baki platform**, bukan kredit Felo Pro. Contoh respons adalah ilustratif; kandungan langsung dan medan pilihan berbeza.

## Titik akhir

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

## Permintaan

| Medan | Jenis | Diperlukan | Makna |
|---|---|---|---|
| `query` | string | Ya | Pertanyaan carian, 1–4,000 aksara |
| `count` | integer | Tidak | Kiraan hasil yang diminta, 1–50; lalai 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}'
```

## Respons

HTTP 200 memulangkan hasil pada akar JSON:

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

| Medan | Makna |
|---|---|
| `resources` | Halaman yang dipulangkan; setiap satu mempunyai `title`, `link` dan `snippet` |
| `total` | Bilangan sumber yang dipulangkan, bukan jumlah halaman di internet |

`count` ialah kiraan yang diminta, bukan jaminan bahawa hasil padanan yang mencukupi wujud. Titik akhir ini tidak mempunyai parameter cursor. Untuk membaca sumber secara penuh, hantar `link`nya ke [Baca Web](https://openapi.felo.ai/ms/docs/data-api/guides/felo-web-read.md).

## Pengebilan dan kegagalan

Unit pengebilan ialah satu permintaan (`web.search`), bukan satu halaman yang dipulangkan. Baca [harga semasa](https://openapi.felo.ai/api/v1/data/prices). Ralat baki atau kuota mesti dikendalikan secara berasingan daripada hasil berjaya yang kosong; lihat [Pengebilan dan Ralat](https://openapi.felo.ai/ms/docs/data-api/guides/felo-billing.md).