Docs › Guides › Den richtigen Endpoint wählen

Den richtigen Endpoint wählen

FourA bietet drei API-Endpoints, die jeweils für unterschiedliche Szenarien optimiert sind. Die richtige Wahl spart Zeit, senkt Kosten und erhöht die Erfolgsquote.

Entscheidungshilfe

Nutze den Single-Endpoint, wenn:

  • Die Zielseite serverseitig gerendert wird (kein JavaScript erforderlich)
  • Du maximale Geschwindigkeit benötigst (normalerweise unter 1 Sekunde)
  • Du Daten von APIs oder statischen HTML-Seiten sammelst

Nutze den Browser-Endpoint, wenn:

  • Die Seite auf JavaScript angewiesen ist, um Inhalte zu rendern
  • Inhalte nach dem ersten Laden der Seite dynamisch 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 403-Fehler oder CAPTCHA-Seiten zurückgegeben haben

Endpoint-Vergleich

Single (POST /api/single/)

Die schnellste Option. Sendet einen HTTP-Request mit realistischen, browserähnlichen Netzwerkcharakteristiken, 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", "unblocker": true}'

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-Browserinstanz. 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 Ideal für: Single-Page-Apps (SPAs), Seiten mit Lazy Loading, über JavaScript gerenderte Inhalte

Proxy (POST /api/proxy/)

Kombiniert HTTP-Requests mit automatischer Proxy-Rotation. Wenn der erste Versuch fehlschlägt oder blockiert wird, 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",
      "unblocker": true
    }
  }'

Typische Antwortzeit: 1 s bis 5 s Ideal für: E-Commerce-Preisüberwachung, Reiseportale, Seiten mit Bot-Erkennung

Wann man Ansätze kombiniert

Einige Workflows profitieren von der Nutzung mehrerer Endpoints:

  1. Mit Single starten: Teste, ob die Seite auch ohne Browser nützliche Daten zurückgibt.
  2. Auf Browser ausweichen: Wenn die Response leer ist oder Inhalte fehlen, wechsle zum Browser-Rendering.
  3. Proxy hinzufügen: Wenn du blockiert wirst (403/CAPTCHA), kapsele deinen Request im Proxy-Endpoint für automatische IP-Rotation.

Dieser schrittweise Ansatz hält die Kosten niedrig und maximiert gleichzeitig die Erfolgsquote.

Performance-Tipps

  • Nutze standardmäßig den Single-Endpoint und wechsle nur bei Bedarf zu den anderen Optionen
  • Setze checkText in Browser-Requests, um unnötige Wartezeiten auf Inhalte zu vermeiden
  • Setze maxTries in Proxy-Requests, um das Retry-Verhalten zu steuern (Standard ist 5, Maximum 90)
  • Halte timeout_ms-Werte realistisch: 10 bis 15 Sekunden reichen für die meisten Seiten aus

Nächste Schritte

Aktualisiert: 30. Juni 2026
Umgang mit Anti-Bot-Schutz →