# Felo Wyszukiwanie w sieci

POST /api/v1/data/web/search

Przeszukaj sieć i otrzymaj strony źródłowe do przetworzenia przez swoją aplikację. Aby uzyskać wygenerowaną odpowiedź ze źródłami, użyj [Chat](https://openapi.felo.ai/pl/docs/data-api/guides/felo-chat.md).

Wszystkie przykłady używają `FELO_API_KEY` z [przeglądu](https://openapi.felo.ai/pl/docs/data-api/guides/felo-overview.md). Wywołania korzystają z **salda platformy**, a nie z kredytów Felo Pro. Przykłady odpowiedzi mają charakter poglądowy; rzeczywista treść i opcjonalne pola mogą się różnić.

## Punkt końcowy

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

## Żądanie

| Pole | Typ | Wymagane | Znaczenie |
|---|---|---|---|
| `query` | string | Tak | Zapytanie wyszukiwania, 1–4 000 znaków |
| `count` | integer | Nie | Żądana liczba wyników, 1–50; domyślnie 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}'
```

## Odpowiedź

HTTP 200 zwraca wyniki w korzeniu JSON:

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

| Pole | Znaczenie |
|---|---|
| `resources` | Zwrócone strony; każda ma `title`, `link` i `snippet` |
| `total` | Liczba zwróconych zasobów, a nie łączna liczba stron w internecie |

`count` to żądana liczba, a nie gwarancja, że istnieje wystarczająco dużo pasujących wyników. Ten punkt końcowy nie ma parametru kursora. Aby odczytać źródło w całości, przekaż jego `link` do [Odczytu strony internetowej](https://openapi.felo.ai/pl/docs/data-api/guides/felo-web-read.md).

## Rozliczenia i błędy

Jednostką rozliczeniową jest jedno żądanie (`web.search`), a nie jedna zwrócona strona. Sprawdź [bieżące ceny](https://openapi.felo.ai/api/v1/data/prices). Błąd salda lub limitu musi być obsłużony oddzielnie od pustego, ale udanego wyniku; zobacz [Rozliczenia i błędy](https://openapi.felo.ai/pl/docs/data-api/guides/felo-billing.md).