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:
- Mit auto erkennen: Übergib eine
validate-Regel und lass die Stufenleiter ermitteln, welche Stufe die Seite braucht. - Mit single wiederholen: Nimm
session.proxy,session.cookiesundsession.userAgent, die auto zurückgegeben hat, und rufe Single damit für Folgeseiten auf demselben Host auf. - Auf Browser zurückgreifen: Wenn Single fehlschlägt, wechsle zum Browser-Rendering.
- 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
checkTextin Browser-Requests, damit eine Seite, die ohne deinen Inhalt gerendert wurde, als Fehler (checkText:<text> not found) statt als Erfolg zurückkommt.checkTextsorgt nicht dafür, dass FourA länger auf den Text wartet. - Setze
maxTriesin Proxy-Requests, um das Retry-Verhalten zu steuern (Standard ist 5, Maximum 90). - Halte
timeout_msin 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): Die Details zu
/api/auto/ - API-Endpoints: Vollständige Parameter-Referenz
- Dynamische Websites scrapen: Schritt-für-Schritt-Anleitung für Browser-Requests
- Schnellstart: Dein erster Request in 30 Sekunden