Erste Schritte
Synchrones Scraping
Der
scrape-Endpunkt startet eine Browser-Sitzung und liefert gerendertes HTML in einer einzigen Anfrage — ideal für Integrationen mit niedriger Latenz.Asynchrone Jobs
Die
jobs-Endpunkte stellen Scraping-Aufgaben in die Warteschlange und ermöglichen das Abfragen von Status und Ergebnissen — ideal für hohes Volumen oder langsame Seiten.REST-Architektur
Die Web-Scraping-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung.HTTPS-Sicherheit
Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.API-Versionierung
Die Web-Scraping-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1.Authentifizierung
Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die Web-Scraping-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel. Übergeben Sie Ihren Schlüssel im JSON-Body alsapi_key.
Basis-URL
Browser-Rendering
Seiten werden in einem echten Headless-Browser gerendert. JavaScript wird vollständig ausgeführt, bevor Inhalte zurückgegeben werden. Integrierter SSRF-Schutz blockiert Anfragen an localhost und private IP-Bereiche.Antwort- und Fehlercodes
Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.| Code | Typ | Beschreibung |
|---|---|---|
| 200 | OK | Alles funktionierte wie erwartet. |
| 202 | Accepted | Asynchroner Job wurde erfolgreich in die Warteschlange gestellt. |
| 400 | Bad request | Fehlerhafte Anfrage — ungültige URL, blockiertes Ziel oder fehlerhafte Nutzlast. |
| 401 | Unauthorized | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig. |
| 422 | Quota reached | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife). |
| 429 | Too many requests | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500 | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden. |