Den richtigen Endpoint auswählen

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

Kurzanleitung zur Entscheidung

Verwende den Auto-Endpoint, wenn:

Du eine neue Seite ansteuerst und noch nicht weißt, was sie benötigt
Du einen Aufruf möchtest, der Direct, Proxy-Rotation und Browser-Fallbacks für dich übernimmt
Du eine Session möchtest, die du beim nächsten Aufruf desselben Hosts günstig wiederverwenden kannst

Verwende den Single-Endpoint, wenn:

Die Seite server-rendered ist (kein JavaScript erforderlich)
Du maximale Geschwindigkeit brauchst (typischerweise unter 1 Sekunde)
Du APIs oder statische HTML-Seiten von einem bekannten funktionierenden Host aufrufst

Verwende den Browser-Endpoint, wenn:

Die Seite JavaScript benötigt, um Inhalte zu rendern
Inhalte nach dem anfänglichen Laden der Seite geladen werden
Du den vollständig gerenderten DOM benötigst

Verwende den Proxy-Endpoint, wenn:

Die Zielseite Requests aktiv blockiert
Du durch mehrere IP-Adressen rotieren musst
Vorherige Versuche 403 oder CAPTCHA-Seiten zurückgaben

Endpoint-Vergleich

Auto (`POST /api/auto/`)

Der Smart-Fetch-Endpoint. Du übergibst eine URL und (idealerweise) eine validate-Regel. FourA durchläuft dann eine kostenbewusste Leiter: günstiger Direct-Probe, rotierter Proxy, vollständiger Browser. Die erste Stufe, die eine Response passend zu deiner validate zurückgibt, gewinnt. Bei wiederholten Aufrufen desselben Hosts wird eine warme Session wiederverwendet, sodass der zweite Aufruf günstig ist.

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 Response-Zeit: 200ms (warm) bis über 30s (kalter Solve bei einer schweren Seite) Am besten für: Neue Ziele, Seiten mit gemischtem Schutz, "Ich will einfach nur die Seite"

Für eine tiefere Anleitung siehe den Smart Fetch Guide.

Single (`POST /api/single/`)

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

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 Response-Zeit: 200ms bis 2s Am besten für: APIs, News-Seiten, Blogs, statische Produktseiten

Browser (`POST /api/browser/`)

Öffnet deine URL in einer Chrome-Browserinstanz. Die Seite wird vollständig geladen, JavaScript wird ausgeführt und du erhältst das final gerenderte HTML.

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 Response-Zeit: 2s bis 10s Am besten für: Single-Page-Apps (SPAs), Seiten mit Lazy Loading, JavaScript-gerenderte Inhalte

Proxy (`POST /api/proxy/`)

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

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 Response-Zeit: 1s bis 5s Am besten für: E-Commerce Preisüberwachung, Reise-Aggregation, Seiten mit Bot-Erkennung

Auto oder Manuell

Wann solltest du Auto wählen lassen und wann solltest du Single, Proxy oder Browser selbst aufrufen?

Auto wählen	Manuell wählen
Du weißt noch nicht, was die Seite benötigt	Du weißt genau, welche Engine das Ziel verlangt
Du willst einen Aufruf, der einfach funktioniert	Du optimierst die Request-Form für ein bekanntes Ziel
Du bist einverstanden, dass Auto eine gelernte Session wiederverwendet	Du willst volle Kontrolle über Retry pro Aufruf, Timeout und Proxy-Wahl
Du zahlst für ein paar Sekunden Probing beim ersten Aufruf	Latenz beim ersten Aufruf ist wichtiger als Discovery

Auto ist nicht immer die günstigere Wahl. Wenn du bereits weißt, dass ein Ziel mit Single und aktiviertem unblocker funktioniert, überspringt der direkte Aufruf von Single das Probe und kostet 2 Credits. Auto für dasselbe Ziel kostet das, was seine Leiter verbraucht.

Wann Ansätze kombiniert werden sollten

Einige Workflows profitieren von der Nutzung mehrerer Endpoints:

Discovery mit Auto: Übergib eine validate-Regel und lass die Leiter herausfinden, welche Stufe die Seite benötigt.
Replay mit Single: Nimm die von Auto zurückgegebenen session.proxy, session.cookies und session.userAgent und rufe Single damit für Folgeseiten auf demselben Host auf.
Fallback auf Browser: Wenn Single anfängt fehlzuschlagen, wechsle zum Browser-Rendering.
Proxy hinzufügen: Wenn du ohne Auto blockiert wirst (403 / CAPTCHA), packe deinen Request in den Proxy-Endpoint für automatische Rotation.

Dieser progressive Ansatz hält die Kosten niedrig, während die Erfolgsquoten hoch bleiben.

Performance-Tipps

Übergib einen validate.data.accept Substring bei geschützten Zielen. Ohne diesen kann Auto eine echte Seite nicht von einem Challenge-Interstitial unterscheiden.
Verwende standardmäßig den Single-Endpoint für funktionierende Hosts und mach nur dann ein Upgrade, wenn es nötig ist.
Setze checkText in Browser-Requests, um nicht auf unnötigen Content zu warten.
Setze maxTries in Proxy-Requests, um das Retry-Verhalten zu steuern (Standard ist 5, Maximum ist 90).
Halte timeout_ms angemessen: 10 bis 15 Sekunden für die meisten Seiten, über 30s für kalte Auto-Durchläufe gegen geschützte Seiten.

Nächste Schritte

Smart Fetch (Auto): Der Deep Dive in /api/auto/
API Endpoints: Vollständige Parameter-Referenz
Eine dynamische Website scrapen: Schritt-für-Schritt Anleitung für Browser-Requests
Schnellstart: Dein erster Request in 30 Sekunden

Aktualisiert: 30. Juni 2026