# Pencarian Web

Temukan halaman web dan kembalikan judul, tautan, serta cuplikan.

Cari web dan terima halaman sumber untuk diproses oleh aplikasi Anda. Untuk jawaban yang dihasilkan dengan sumber, gunakan [Chat](https://openapi.felo.ai/id/docs/data-api/guides/felo-chat.md).

Semua contoh menggunakan `FELO_API_KEY` dari [gambaran umum](https://openapi.felo.ai/id/docs/data-api/guides/felo-overview.md). Panggilan menggunakan **saldo platform**, bukan kredit Felo Pro. Contoh respons bersifat ilustratif; konten langsung dan bidang opsional bervariasi.

## Endpoint

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

## Permintaan

| Bidang | Tipe | Wajib | Arti |
|---|---|---|---|
| `query` | string | Ya | Kueri pencarian, 1–4.000 karakter |
| `count` | integer | Tidak | Jumlah hasil yang diminta, 1–50; default 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 mengembalikan hasil di root JSON:

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

| Bidang | Arti |
|---|---|
| `resources` | Halaman yang dikembalikan; masing-masing memiliki `title`, `link`, dan `snippet` |
| `total` | Jumlah resource yang dikembalikan, bukan total jumlah halaman di internet |

`count` adalah jumlah yang diminta, bukan jaminan bahwa cukup hasil yang cocok tersedia. Endpoint ini tidak memiliki parameter cursor. Untuk membaca sumber secara penuh, kirim `link`-nya ke [Baca Web](https://openapi.felo.ai/id/docs/data-api/guides/felo-web-read.md).

## Penagihan dan kegagalan

Unit penagihan adalah satu permintaan (`web.search`), bukan satu halaman yang dikembalikan. Baca [harga terkini](https://openapi.felo.ai/api/v1/data/prices). Kesalahan saldo atau kuota harus ditangani terpisah dari hasil sukses yang kosong; lihat [Penagihan dan Kesalahan](https://openapi.felo.ai/id/docs/data-api/guides/felo-billing.md).