# Web Arama

Web sayfalarını bulun ve başlıkları, bağlantıları ve özetleri döndürün.

Web’de arama yapın ve uygulamanızın işlemesi için kaynak sayfalar alın. Kaynaklarla birlikte üretilmiş bir yanıt için [Sohbet](https://openapi.felo.ai/tr/docs/data-api/guides/felo-chat.md) bölümünü kullanın.

Tüm örnekler [genel bakış](https://openapi.felo.ai/tr/docs/data-api/guides/felo-overview.md) içindeki `FELO_API_KEY`’i kullanır. Çağrılar Felo Pro kredilerini değil, **platform bakiyesini** kullanır. Yanıt örnekleri açıklayıcıdır; canlı içerik ve isteğe bağlı alanlar değişebilir.

## Uç nokta

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

## İstek

| Alan | Tür | Gerekli | Anlamı |
|---|---|---|---|
| `query` | string | Evet | Arama sorgusu, 1–4.000 karakter |
| `count` | integer | Hayır | İstenen sonuç sayısı, 1–50; varsayılan 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}'
```

## Yanıt

HTTP 200, sonuçları JSON kökünde döndürür:

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

| Alan | Anlamı |
|---|---|
| `resources` | Dönen sayfalar; her birinde `title`, `link` ve `snippet` bulunur |
| `total` | Dönen kaynakların sayısı, internetteki toplam sayfa sayısı değil |

`count`, istenen sayıdır; yeterli eşleşen sonuç bulunduğunun garantisi değildir. Bu uç noktanın cursor parametresi yoktur. Bir kaynağı tam olarak okumak için onun `link` değerini [Web Okuma](https://openapi.felo.ai/tr/docs/data-api/guides/felo-web-read.md) bölümüne gönderin.

## Faturalandırma ve hatalar

Faturalandırma birimi bir istektir (`web.search`), dönen her sayfa değil. [Güncel fiyatları](https://openapi.felo.ai/api/v1/data/prices) okuyun. Bakiye veya kota hatası, boş ama başarılı bir sonuçtan ayrı şekilde ele alınmalıdır; [Faturalandırma ve Hatalar](https://openapi.felo.ai/tr/docs/data-api/guides/felo-billing.md) bölümüne bakın.