API-Fehler
Die Web Scraping API gibt standardmäßige HTTP-Statuscodes zurück. Antworten außerhalb des 2xx-Bereichs enthalten einen JSON-Body mit einem error-Feld, das beschreibt, was schiefgelaufen ist.
Fehlercodes
Abschnitt betitelt „Fehlercodes“| Code | Bedeutung |
|---|---|
400 | Bad Request. Die Anfrage ist fehlerhaft aufgebaut oder enthält ungültige Parameter. Wird auch zurückgegeben, wenn die Ziel-URL nicht gescrapt werden konnte. |
401 | Unauthorized. Der API-Schlüssel fehlt, ist ungültig, oder das Guthabenkontingent ist ausgeschöpft. |
403 | Forbidden. Ihr Plan enthält diese Funktion nicht (zum Beispiel JavaScript-Rendering oder länderspezifische Geolokalisierung). Führen Sie ein Upgrade Ihres Abonnements durch, um sie zu nutzen. |
406 | Not Acceptable. Das angeforderte Antwortformat wird nicht unterstützt. |
422 | Unprocessable Entity. Die Anfrage war gültig, konnte aber nicht ausgeführt werden. Häufige Ursachen: Die Zielseite hat unter einem 200 OK ein CAPTCHA zurückgegeben, das Antwort-HTML ist leer, ein Instagram-Profil hat die Login-Seite zurückgegeben, oder ein wait_for_css-Selektor ist nie erschienen. |
429 | Too Many Requests. Sie senden Anfragen zu schnell oder führen zu viele parallel aus. Google kann diesen Code ebenfalls zurückgeben, wenn es den Scraper erkennt. |
500 | Internal Server Error. Auf unserer Seite ist etwas fehlgeschlagen. Versuchen Sie es in Kürze erneut. |
503 | Service Unavailable. Die API ist vorübergehend wegen Wartungsarbeiten offline. Versuchen Sie es später erneut. |
Wiederholungslogik
Abschnitt betitelt „Wiederholungslogik“- Wiederholen Sie
500und503mit exponentiellem Backoff (zum Beispiel 1s, 2s, 4s). - Wiederholen Sie
429nach einer Pause und reduzieren Sie die Anfrage-Parallelität. - Wiederholen Sie
400,401,403oder406nicht, ohne die Anfrage zu ändern.
Siehe auch
Abschnitt betitelt „Siehe auch“- Web Scraping API - Endpoint-Übersicht
- Grundlegende Anfrage - Minimalbeispiel für einen Aufruf