Den richtigen Endpoint auswählen

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.

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.

Single (POST /api/single/)

Die schnellste Option. Sendet einen HTTP-Request mit realistischen, browserähnlichen Wire-Eigenschaften, 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 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.

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.

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

Aktualisiert: 5. November 2026