# Websuche

Finde Webseiten und gib Titel, Links und Snippets zurück.

Durchsuche das Web und erhalte Quellseiten für deine Anwendung zur Verarbeitung. Für eine generierte Antwort mit Quellen verwende [Chat](https://openapi.felo.ai/de/docs/data-api/guides/felo-chat.md).

Alle Beispiele verwenden `FELO_API_KEY` aus der [Übersicht](https://openapi.felo.ai/de/docs/data-api/guides/felo-overview.md). Aufrufe verwenden **Plattform-Guthaben**, nicht Felo-Pro-Guthaben. Antwortbeispiele sind illustrativ; Live-Inhalte und optionale Felder variieren.

## Endpunkt

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

## Anfrage

| Feld | Typ | Erforderlich | Bedeutung |
|---|---|---|---|
| `query` | string | Ja | Suchanfrage, 1–4.000 Zeichen |
| `count` | integer | Nein | Angeforderte Ergebnisanzahl, 1–50; Standard 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}'
```

## Antwort

HTTP 200 gibt die Ergebnisse an der JSON-Root zurück:

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

| Feld | Bedeutung |
|---|---|
| `resources` | Zurückgegebene Seiten; jede hat `title`, `link` und `snippet` |
| `total` | Anzahl der zurückgegebenen Ressourcen, nicht die Gesamtzahl der Seiten im Internet |

`count` ist die angeforderte Anzahl, keine Garantie dafür, dass genügend passende Ergebnisse existieren. Dieser Endpunkt hat keinen Cursor-Parameter. Um eine Quelle vollständig zu lesen, übergib ihren `link` an [Web lesen](https://openapi.felo.ai/de/docs/data-api/guides/felo-web-read.md).

## Abrechnung und Fehler

Die Abrechnungseinheit ist eine Anfrage (`web.search`), nicht eine zurückgegebene Seite. Lies die [aktuellen Preise](https://openapi.felo.ai/api/v1/data/prices). Ein Fehler wegen Guthaben oder Kontingent muss getrennt von einem leeren erfolgreichen Ergebnis behandelt werden; siehe [Abrechnung und Fehler](https://openapi.felo.ai/de/docs/data-api/guides/felo-billing.md).