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 direkte Anfragen, 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 benötigst (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 JavaScript benötigt, 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 Anfragen aktiv blockiert
• Du über mehrere IP-Adressen rotieren musst
• Vorherige Versuche 403-Fehler 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 Eskalationsstufe: zuerst ein rotierter Proxy, dann ein vollständiger Browser über einen Proxy. Setze forceProxy: false, damit vor beiden Schritten ein günstiger direkter Probe-Request und ein direktes Browser-Rendering ausgeführt werden. Die erste Stufe, die eine Antwort liefert, die deiner validate entspricht, gewinnt. Bei wiederholten Aufrufen desselben Hosts wird eine aufgewärmte Session wiederverwendet, sodass der zweite Aufruf kostengü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 auf geschützten Seiten) Optimal für: Neue Ziele, gemischt geschützte Seiten, "Ich will einfach die Seite"

Für eine detaillierte Anleitung siehe den Smart-Fetch-Leitfaden.

Single (POST /api/single/)

Die schnellste Option. Sendet einen HTTP-Request mit realistischen Browser-Wire-Eigenschaften, ohne einen Browser-Prozess 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 wird vollständig geladen, 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: 2s bis 10s Optimal für: Single-Page-Apps (SPAs), Websites mit Lazy Loading, JavaScript-gerenderten Content

Proxy (POST /api/proxy/)

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

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: 1 s bis 5 s Ideal für: E-Commerce-Preismonitoring, Reiseaggregation, Websites mit Bot-Erkennung

Auto im Vergleich zu Manuell

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

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 Single-Aufruf das Probing und kostet 2 Credits. Auto kostet beim selben Ziel so viel, wie seine Ladder verbraucht.

Wann man Ansätze kombinieren sollte

Einige Workflows profitieren von der Nutzung mehrerer Endpoints:

1. Erkennen mit Auto: Übergib eine validate-Regel und lass die Ladder ermitteln, welche Stufe die Website benötigt.
2. Wiederholen mit Single: 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. Fallback auf Browser: Wenn Single fehlschlägt, wechsle zum Browser-Rendering.
4. Proxy hinzufügen: Wenn deine Requests ohne Auto abgelehnt werden (403 oder Verifizierungsseite), leite den Request über den Proxy-Endpoint für automatische Rotation.

Dieser progressive Ansatz hält die Kosten niedrig und die Erfolgsquote hoch.

Performance-Tipps

• Übergib einen validate.data.accept-Substring bei geschützten Zielen. Auto erkennt gängige Challenge-Seiten von selbst, aber nur deine Regel fängt unbekannte Prüfseiten ab oder Seiten, die ohne den benötigten Inhalt geladen wurden.
• Verwende standardmäßig den Single-Endpoint für bekanntermaßen funktionierende Hosts und upgrade nur bei Bedarf.
• 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 führt nicht dazu, 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 sinnvollen Rahmen: 10 bis 15 Sekunden für die meisten Seiten, 30 s+ für initiale Auto-Durchläufe auf geschützten Websites.

Nächste Schritte

• Smart Fetch (Auto): Details zu /api/auto/
• API Endpoints: Vollständige Parameter-Referenz
• Scrape a Dynamic Website: Schritt-für-Schritt-Anleitung für Browser-Requests
• Quick Start: Dein erster Request in 30 Sekunden