# Den richtigen Endpoint auswählen

> URL: https://foura.ai/de/docs/guides/choosing-task-type
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

FourA bietet vier Request-Endpoints, die jeweils für ein anderes Szenario optimiert sind. Die Wahl des richtigen Endpoints spart Zeit, senkt Kosten und verbessert die Erfolgsrate.

## Schnelle Entscheidungshilfe

**Nutze den auto-Endpoint, wenn:**
- Du eine neue Website ansteuerst und noch nicht weißt, was sie erfordert
- Du einen einzigen Aufruf willst, der Proxy-Rotation und Browser-Fallbacks für dich übernimmt
- Du eine Session willst, die du beim nächsten Aufruf desselben Hosts kostengünstig wiederverwenden kannst

**Nutze den single-Endpoint, wenn:**
- Die Seite serverseitig gerendert wird (kein JavaScript erforderlich)
- Du maximale Geschwindigkeit brauchst (typischerweise unter 1 Sekunde)
- Du APIs oder statische HTML-Seiten von einem Host aufrufst, von dem du bereits weißt, dass er funktioniert

**Nutze den browser-Endpoint, wenn:**
- Die Seite auf JavaScript angewiesen ist, um Inhalte zu rendern
- Inhalte nach dem initialen Laden der Seite nachgeladen werden
- Du das vollständig gerenderte DOM benötigst

**Nutze den proxy-Endpoint, wenn:**
- Die Zielseite Requests aktiv blockiert
- Du über mehrere IP-Adressen rotieren musst
- Vorherige Versuche den Status 403 oder Verifizierungsseiten zurückgegeben haben

## Endpoint-Vergleich

### Auto (`POST /api/auto/`)

Der Smart-Fetch-Endpoint. Du übergibst eine URL und (idealerweise) eine `validate`-Regel, und FourA durchläuft eine kostenoptimierte Kaskade: zuerst ein rotierter Proxy, dann ein vollständiger Browser über einen Proxy. Setze `forceProxy: false`, und eine günstige direkte Probe sowie ein direktes Browser-Rendering laufen vor beiden. Die erste Stufe, die eine Antwort passend zu deinem `validate` liefert, gewinnt. Bei wiederholten Aufrufen desselben Hosts wird eine aufgewärmte Session wiederverwendet, sodass der zweite Aufruf günstig ist.

```bash
curl -X POST https://eu.api.foura.ai/api/auto/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/product/42",
    "validate": {"data": {"accept": ["Add to cart"]}}
  }'
```

**Typische Antwortzeit:** 200 ms (warm) bis 30 s+ (Cold Solve bei schwierigen Websites)
**Optimal für:** Neue Ziele, Websites mit gemischtem Schutz, "Ich will einfach nur die Seite"

Eine ausführlichere Anleitung findest du im [Smart-Fetch-Leitfaden](https://foura.ai/docs/guides/smart-fetch).

### Single (`POST /api/single/`)

Die schnellste Option. Sendet einen HTTP-Request mit realistischen, browserähnlichen Wire-Eigenschaften, ohne einen Browserprozess zu starten.

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com/api/products"}'
```

**Typische Antwortzeit:** 200 ms bis 2 s
**Ideal für:** APIs, Nachrichtenseiten, Blogs, statische Produktseiten

### Browser (`POST /api/browser/`)

Öffnet deine URL in einer Chrome-Browser-Instanz. Die Seite lädt vollständig, JavaScript wird ausgeführt und du erhältst das fertig gerenderte HTML.

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/spa-app",
    "timeout_ms": 15000,
    "checkText": "data-table"
  }'
```

**Typische Antwortzeit:** 2 s bis 10 s
**Optimal für:** Single-Page-Apps (SPAs), Websites mit Lazy Loading, per JavaScript gerenderten Content

### Proxy (`POST /api/proxy/`)

Kombiniert HTTP-Requests mit automatischer Proxy-Rotation. Schlägt der erste Versuch fehl oder wird blockiert, versucht es FourA über andere Proxys erneut.

```bash
curl -X POST https://eu.api.foura.ai/api/proxy/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "maxTries": 5,
    "request": {
      "method": "GET",
      "url": "https://example.com/pricing"
    }
  }'
```

**Typische Antwortzeit:** 1s bis 5s
**Optimal für:** E-Commerce-Preisüberwachung, Reise-Aggregatoren, Websites mit Bot-Erkennung

## Auto vs. Manuell

Wann solltest du auto entscheiden lassen und wann Single, Proxy oder Browser selbst aufrufen?

| Wähle auto | Wähle manuell |
|-----------|-------------|
| Du weißt noch nicht, was die Website benötigt | Du weißt genau, welche Engine das Ziel verlangt |
| Du willst einen einzigen Aufruf, der einfach funktioniert | Du optimierst die Request-Struktur für ein bekanntes Ziel |
| Es ist in Ordnung für dich, wenn auto eine gelernte Session wiederverwendet | Du willst die volle Kontrolle über Retry, Timeout und Proxy-Auswahl pro Aufruf |
| Ein paar Sekunden Ausprobieren beim ersten Aufruf sind akzeptabel | Latenz beim ersten Aufruf ist wichtiger als Erkennung |

Auto ist nicht immer die günstigere Wahl. Wenn du bereits weißt, dass ein Ziel mit Single und aktivem `unblocker` funktioniert, überspringt der direkte Aufruf von Single die Stufenleiter und kostet 2 Credits. Auto kostet beim selben Ziel so viel, wie seine Stufenleiter verbraucht.

## Wann Ansätze kombiniert werden sollten

Manche Workflows profitieren von der Nutzung mehrerer Endpoints:

1. **Mit auto erkennen**: Übergib eine `validate`-Regel und lass die Stufenleiter ermitteln, welche Stufe die Seite braucht.
2. **Mit single wiederholen**: Nimm `session.proxy`, `session.cookies` und `session.userAgent`, die auto zurückgegeben hat, und rufe Single damit für Folgeseiten auf demselben Host auf.
3. **Auf Browser zurückgreifen**: Wenn Single fehlschlägt, wechsle zum Browser-Rendering.
4. **Proxy hinzufügen**: Wenn deine Requests ohne auto abgewiesen werden (403 oder eine Verifizierungsseite), leite deinen Request über den Proxy-Endpoint für automatische Rotation.

Dieser schrittweise Ansatz hält die Kosten niedrig und sorgt für hohe Erfolgsraten.

## Performance-Tipps

- Übergib bei geschützten Zielen einen `validate.data.accept`-Substring. Auto erkennt gängige Challenge-Seiten von selbst, aber nur deine Regel fängt unbekannte Prüfseiten ab oder Seiten, die ohne den gewünschten Inhalt geladen wurden.
- Nutze standardmäßig den Single-Endpoint für bekanntermaßen funktionierende Hosts und stufe nur bei Bedarf hoch.
- Setze `checkText` in Browser-Requests, damit eine Seite, die ohne deinen Inhalt gerendert wurde, als Fehler (`checkText:<text> not found`) statt als Erfolg zurückkommt. `checkText` sorgt nicht dafür, dass FourA länger auf den Text wartet.
- Setze `maxTries` in Proxy-Requests, um das Retry-Verhalten zu steuern (Standard ist 5, Maximum 90).
- Halte `timeout_ms` in einem vernünftigen Rahmen: 10 bis 15 Sekunden für die meisten Seiten, 30s+ für initiale auto-Aufrufe bei geschützten Websites.

## Nächste Schritte

- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch): Die Details zu `/api/auto/`
- [API-Endpoints](https://foura.ai/docs/api/endpoints): Vollständige Parameter-Referenz
- [Dynamische Websites scrapen](https://foura.ai/docs/how-to/scrape-dynamic-website): Schritt-für-Schritt-Anleitung für Browser-Requests
- [Schnellstart](https://foura.ai/docs/getting-started/quick-start): Dein erster Request in 30 Sekunden
