ScraperFlyWebdaten-API für KI

request control

Fehlerbehandlung der Scraping-API, die zu klaren nächsten Schritten führt

Ein fehlgeschlagener Scrape sollte dem Team sagen, was als Nächstes zu tun ist. ScraperFly hilft Entwicklern, schlechte Eingaben, Kontingentgrenzen, Zugriffsfehler auf der Zielseite, Ratenlimits, Rendering-Probleme, leere Antworten, übergroße Erfassungen und Ausgabefehler zu trennen, sodass jeder erneute Versuch einen Grund hat.

Evidenzbasierte Wiederherstellung

Beheben Sie die Ursache, bevor Sie die Anfrage wiederholen

Scraping-Fehler werden teuer, wenn jeder Fehler die gleiche Antwort erhält: härter wiederholen. Eine falsche URL, ein ungültiger Schlüssel, ein Ziel 403, ein 429-Limit, ein Render-Timeout, eine leere HTML-Hülle und eine übergroße Antwort sind unterschiedliche Probleme mit unterschiedlichen Lösungen.

ScraperFly gibt Teams die Anforderungsbeweise, die sie benötigen, um den nächsten Schritt bewusst zu wählen. Überprüfen Sie den Status, die endgültige URL, die Antwortgröße, den Inhaltstyp, das Ausgabeformat, das Renderverhalten und die Zielsignale, bevor Sie die Browserausführung, Sitzungen, Header, Länderrouting oder Premium-Lieferung hinzufügen.

diagnostizierenmit Backoff wiederholenmit Beweisen eskalieren
Team überprüft die Fehlerkategorien der Scraping-API und die nächsten Schritte auf einem Dashboard

Was muss die Fehlerbehandlung der Scraping-API beantworten?

Eine gute Fehlerbehandlung sagt mehr als nur, dass eine Anfrage fehlgeschlagen ist. Sie sollte beantworten, ob das Problem von der Anfrage, dem Konto, dem Ziel, dem Netzwerkpfad, dem Browser-Render, der gewählten Ausgabe oder dem nachgelagerten Parser stammt. Diese Klassifizierung entscheidet, ob die nächste Maßnahme Korrektur, Wiederholung, Warten, Eskalation oder eine kleinere Erfassung ist.

Deshalb sollte ein zuverlässiger Scraping-Workflow sowohl den sichtbaren Fehler als auch die umgebenden Beweise protokollieren. Eine 200-Antwort mit einem winzigen HTML-Body kann weniger nützlich sein als ein klares 403. Ein erfolgreicher Screenshot einer Fehlerseite ist immer noch ein Zielversagen. Ein PDF-Timeout kann ein Problem mit dem Ausgabeumfang sein, nicht ein Proxy-Problem.

Praktische Erkenntnis: Behandeln Sie jeden Fehler als eine Routing-Entscheidung für die nächste Anfrage, nicht als einen Befehl, dasselbe Profil zu wiederholen.

Welche Scraping-Fehler sollten behoben und nicht wiederholt werden?

Einige Fehler sollten den Workflow sofort stoppen, da eine andere identische Anfrage nicht erfolgreich sein kann. Fehlende URLs, fehlerhafte URLs, nicht unterstützte Formate, ungültige API-Schlüssel, pausierte Schlüssel, inkompatible Dateioptionen und unmögliche Ausgabe-Kombinationen sind Konfigurationsprobleme. Sie benötigen Validierung und besseres Feedback, nicht Backoff.

Fehler, die zuerst behoben werden müssen, sind Bereiche, in denen API-Disziplin Geld spart. Wenn die Anfrage ungültig ist, verbirgt das Ausgeben von Credits für Rendering, Premium-Routing oder wiederholte Versuche nur das eigentliche Problem. Validieren Sie die Anforderungsform frühzeitig und senden Sie Produktionsbatches erst, nachdem die Basisanforderung korrekt ist.

FehlergruppeHäufiges SignalBessere nächste Maßnahme
EingangsvalidierungFehlende URL, ungültige URL, nicht unterstützter ParameterDie Anfrage vor der Wiederholung korrigieren
AuthentifizierungFehlender, ungültiger, deaktivierter oder pausierter API-SchlüsselKonto- oder Schlüsselkonfiguration beheben
Auswahl der AusgabeNicht unterstütztes Format, inkompatible Screenshot- oder PDF-OptionEin unterstütztes Antwortformat wählen
UmfangsproblemÜbergroße Antwort oder DateierfassungDie Erfassung einschränken oder eine leichtere Ausgabe verwenden

Welche Fehler verdienen kontrollierte Wiederholungen?

Vorübergehende Fehler können wiederholt werden, aber die Wiederholungsrichtlinie sollte begrenzt sein. Netzwerk-Timeouts, vorübergehende 5xx-Antworten und ausgewählte 429-Rate-Limits können sich nach Backoff erholen. Sie sofort mit höherer Parallelität zu wiederholen, macht den Workflow normalerweise weniger stabil.

Eine starke Wiederholungsrichtlinie protokolliert den Grund, wartet vor dem nächsten Versuch, begrenzt die Gesamtwiederholungen und ändert die Anfrage nur, wenn die Beweise eine Änderung unterstützen. Zum Beispiel kann ein Ziel-seitiger 403-Fehler eine Analyse des Zugriffs-Kontexts benötigen, nicht eine generische Wiederholungsschleife. Eine leere HTML-Antwort kann einen Vergleich zwischen Roh- und gerenderten Inhalten benötigen, bevor eine Routing-Änderung vorgenommen wird.

FehlerWiederholungsstrategieZu überprüfende Beweise
TimeoutMit einer Grenze und Backoff wiederholenDauer, Zielstabilität, Renderzeit, Antwortbeginn
5xx-Antwort von obenWiederholen, wenn ein vorübergehendes Muster plausibel istStatusverlauf, endgültige URL, Größe des Antwortkörpers
429-Rate-LimitLangsam machen, bevor der Druck erhöht wirdParallelität, Anfragefrequenz, Kontingente, Zieltoleranz
403-ZielantwortDiagnostizieren, bevor Sie wiederholenHeader, Region, Cookies, Rendering, Routenverhalten

Wann sollten Rendering, Wartezeiten oder Routing eskaliert werden?

Eskalation sollte Beweisen folgen. Aktivieren Sie das JavaScript-Rendering, wenn der nützliche öffentliche Inhalt aus dem Quell-HTML fehlt und nach der Browserausführung erscheint. Fügen Sie Render-Wartezeiten hinzu, wenn der Browser die Seite öffnet, der Inhalt jedoch später geladen wird. Berücksichtigen Sie Header, Cookies, Sitzungen, Länderauswahl oder Premium-Routing, wenn die Antwortbeweise auf Kontext, Kontinuität, Geografie oder Zielverhalten hinweisen.

Der Schlüssel ist, nicht jedes Ziel zur schwersten Anfrage zu machen. Verwenden Sie Rendering für Seiten, die eine Browserausführung benötigen, überprüfen Sie die Render-Timeout-Beweise, wenn die Browserarbeit fehlschlägt, und inspizieren Sie Antwort-zu-groß-Fälle, bevor Sie dasselbe Profil skalieren.

Praktische Erkenntnis: Eskalieren Sie eine Kontrolle nach der anderen, damit das Team lernt, was tatsächlich die Antwort behoben hat.

Wie macht ScraperFly Wiederherstellungsentscheidungen praktisch?

ScraperFly hilft Entwicklern, die Wiederherstellung um beobachtbare Anforderungsbeweise zu gestalten: Status, endgültige URL, Inhaltstyp, Antwortgröße, Ausgabeformat, Renderverhalten und Routing-Profil. Das erleichtert es, einfache Ziele leicht zu halten, während schwierigere Ziele einen klaren Weg zu Rendering, Sitzungen, Headern, Länderauswahl, Premium-Routing, Screenshots oder PDFs erhalten, wenn sie gerechtfertigt sind.

Verwenden Sie den API Builder, um die Zielanfrage zu reproduzieren, Ausgabeformate zu vergleichen und die nächste Kontrolle zu testen, bevor Sie eine Wiederholungsrichtlinie in den Code einfügen. Verwenden Sie dann Preise und den Kalkulator für die Kosten von Web-Scraping-API-Credits, um sicherzustellen, dass Wiederherstellungsexperimente mit der tatsächlichen Arbeitslast übereinstimmen.

Fehlerdiagnose

Passen Sie den Wiederherstellungsweg an das Zielverhalten an

Die Fehlerbehandlung wird einfacher, wenn Teams wissen, ob das Ziel statisch, JavaScript-lastig, regional, zustandsbehaftet, rate-limitiert, übergroß, blockiert oder eine vorübergehende Fehlerantwort von oben zurückgibt. ScraperFly hilft, diese Beweise in die nächste nützliche Anfrage umzuwandeln, anstatt ein lauteres Wiederholen.

Roh-HTML-Antwort, die auf sichtbare Seitendaten abgebildet ist
01

Verfügbarkeit von Roh-HTML

Überprüfen Sie, ob die benötigten Felder bereits in der ersten HTML-Antwort vorhanden sind.

Bester erster Test für einfache Seiten, Artikel, Dokumente, Listen und Produktdetails.

Vergleich vor und nach der JavaScript-Rendering
02

JavaScript-Abhängigkeit

Vergleichen Sie das Roh-HTML mit dem gerenderten DOM oder Screenshot, bevor Sie das Browser-Rendering aktivieren.

Verwenden Sie Rendering, wenn das Roh-HTML nur eine Hülle ist und Skripte den nützlichen Inhalt erstellen.

Cookies, Zustimmung, Sitzung und Zugriffs-Kontext für das Scraping
03

Status & Zugriffs-Kontext

Identifizieren Sie, ob Cookies, Zustimmung, Anmeldegrenzen, Pagination oder der gleiche Besucherstatus die Antwort beeinflussen.

Verwenden Sie Sitzungen und Header, wenn die Kontinuität die Daten, die Sie erhalten, verändert.

Regionale Inhaltsvariationen über Länder und Routen hinweg
04

Geo-/Inhaltsvariation

Testen Sie, ob Land, Sprache, Währung, Inventar, SERP, Anzeigen oder Routenreputation das Ergebnis verändern.

Verwenden Sie Geo- oder Premium-Routing nur, wenn sichergestellt ist, dass die Antwort je nach Route variiert.

Überprüfungen, bevor Sie die Wiederherstellungsstrategie wählen

Wo befindet sich das Ziel-Feld?

Finden Sie heraus, ob das Feld im Roh-HTML, im gerenderten DOM, einem API-Aufruf, strukturierten Daten, einer Datei oder einem späteren Interaktionszustand vorhanden ist.

Was ändert die Antwort?

Probieren Sie einige URLs aus und vergleichen Sie Status, endgültige URL, Inhaltslänge, Weiterleitungen, leere Zustände und sichtbare Ergebnisunterschiede.

Welcher Kontext ist erforderlich?

Markieren Sie alle Abhängigkeiten von Zustimmung, Gebietsschema, Cookies, Headern, Authentifizierungsgrenzen, Paginierung, Filtern oder vorherigen Anfragen.

Wie sieht ein Fehler aus?

Definieren Sie die Signale für blockierte, teilweise, veraltete, umgeleitete, leere, zeitüberschreitende oder regionsfremde Antworten, bevor Sie skalieren.

Kartieren Sie das Zielverhalten, bevor Sie die Kontrollen ändern

Abrufmodus

Die Verfügbarkeit von Roh-HTML entscheidet, ob die erste Anfrage einfach bleiben kann oder Rendering, Wartezeiten, Screenshots oder Extraktion benötigt.

Anfragekontext

Statusanforderungen entscheiden, ob Header, Cookies, Sitzungen, Zustimmungsverwaltung oder ein stabiler Besucherprofil hinzugefügt werden müssen.

Routing-Wahl

Geo- und Reputationsfunde entscheiden, ob das Standard-Routing ausreicht oder eine Länder-/Premium-Route gerechtfertigt ist.

Validierungsregeln

Bekannte Fehlerzustände werden zu Prüfungen für Wiederholungen, Eskalationen, QA-Überprüfungen und zur Entscheidung, wann ein leichteres Profil dennoch vollständig ist.

Wiederherstellungsanfrage-Builder

Baue die nächste Anfrage aus den Beweisen der Antwort auf

Verwenden Sie Status, endgültige URL, Antwortgröße, Inhaltstyp, Fehlerkategorie und Ausgabebeweise, um zu entscheiden, ob der nächste Durchlauf Validierung, Rendering, Wartezeiten, Header, Sitzungen, Länderauswahl, Premium-Routing oder einen kleineren Erfassungsumfang benötigt.

CFG
Einrichtung

Beheben Sie schlechte Eingaben, bevor Sie für Wiederholungen ausgeben

Fehlende URLs, ungültige Schlüssel, nicht unterstützte Formate und inkompatible Dateioptionen sind Konfigurationsarbeiten, keine Lieferarbeiten.

missing_urlungültiger_schlüssel
NET
Lieferung

Behandle Ziel- und Netzwerkfehler unterschiedlich

Timeouts, 5xx-Antworten, Weiterleitungen, Rate-Limits und blockierte Seiten weisen auf unterschiedliche Wiederherstellungswege hin.

Zeitüberschreitung403429
OUT
Ausgabe

Überprüfe die Antwortstruktur, bevor du den Parser-Code änderst

Leere HTML, übergroße Antworten, PDFs, Screenshots und gerenderte Ausgaben benötigen Beweise, bevor sich die Parser-Regeln ändern.

leeres htmlPDFScreenshot

Signale, die die Fehlerbehebung beim Scraping leiten

status

HTTP-Ergebnis oder ScraperFly-Fehlerkategorie.

final_url

Die URL nach Weiterleitungen und Zielbehandlung.

size

Antwortgröße, die auf leere, blockierte oder übergroße Ausgaben hinweist.

format

Die Ausgabestruktur, in der der Fehler aufgetreten ist.

cURL-Beispiel

Generieren Sie Markdown mit derselben Anfrageform, die Sie in die Produktion überführen können.

curl "https://scraperfly.com/api/v1?url=https%3A%2F%2Fexample.com&format=markdown" \
  -H "apikey: YOUR_API_KEY"

Kostenkontrolle bei der Wiederherstellung

Halte Wiederholungen erschwinglich, indem du die Ursache behebst, nicht die gleiche Anfrage wiederholst

Blindes Wiederholen verwandelt kleine Fehler in teure Chargen. Gezielte Wiederherstellung hält Credits auf dem nächsten nützlichen Experiment fokussiert: korrigiere schlechte Eingaben, verlangsamen rate-limitierten Jobs, rendere nur, wenn die Quelle unvollständig ist, und eskaliere das Routing nur, wenn Beweise des Ziels dies unterstützen.

Eine leichte HTML-Anfrage, die eine einfache Antwort zurückgibt
01

Einfacher Abruf

Verwenden Sie einen einfachen Abruf, wenn das öffentliche HTML bereits die benötigten Felder enthält.

Leichtestes Anfrageprofil; behalten Sie es, wenn die Antwort vollständig ist.

JavaScript-Rendering, das ein vollständiges DOM erzeugt
02

Rendering

Verwenden Sie Rendering, wenn rohes HTML eine Hülle ist und JavaScript die Seite vervollständigt.

Schwereres Profil; verwenden Sie es nur, wenn die Browserausgabe das Ergebnis ändert.

Mehrere Anfragen, die Cookies und den Besucherstatus beibehalten
03

Zustandsbehaftete Sitzung

Verwenden Sie Sitzungen, wenn Cookies, Zustimmung, Sprache oder Paginierung die Antwort ändern.

Schwereres Zustandsprofil; bewahren Sie es nur, wenn Kontinuität wichtig ist.

Anforderungsrouting über Geo- und hochwertigere Routen
04

Premium-Routing & Geo

Verwenden Sie Premium-Routing oder Geo nur, wenn Herkunft, Land, Ruf oder regionale Inhalte das Ergebnis ändern.

Schwerstes Routing-Profil; wenden Sie es nur auf Ziele an, die nachweisen, dass sie es benötigen.

Was macht die Fehlerbehebung schwerer

Mehr Infrastrukturarbeit

Browser-Rendering, Routing-Entscheidungen und längere Wartezeiten bedeuten, dass die Plattform mehr tun muss, als nur eine einfache Antwort zurückzugeben.

Mehr Zielunsicherheit

Weiterleitungen, leere Zustände, Ratenlimits und Challenge-Seiten erfordern oft stärkere Lieferoptionen oder Wiederholungen.

Mehr Zustand zu bewahren

Cookies, Sitzungen, Einwilligungen und mehrseitige Abläufe fügen bewegliche Teile hinzu, die ein einfacher zustandsloser Abruf nicht hat.

Mehr Beweise zurückzugeben

Screenshots, PDFs, gerenderte Ausgaben und reichhaltigere Antwortartefakte sind nützlich, aber sie sind schwerer als einfaches HTML.

Wie man Wiederherstellungsdurchläufe vorhersehbar hält.

Beispiel vor der Skalierung

Testen Sie zuerst eine kleine URL-Gruppe und gruppieren Sie Ziele nach dem leichtesten Profil, das vollständige Daten zurückgibt.

Standardmäßig nicht rendern

Überprüfen Sie das rohe HTML, bevor Sie das Rendering aktivieren. Viele öffentliche Seiten enthalten bereits die Daten, die Sie benötigen.

Eskalieren Sie anhand von Beweisen

Steigen Sie nur auf, wenn die Antwort fehlende Inhalte, Zustandsabhängigkeit, geo-variationen oder Routing-Probleme zeigt.

Nützliche Ergebnisse messen

Optimieren Sie basierend auf gültigen gelieferten Datensätzen, nicht auf dem Rohanfragevolumen. Ein leichteres Profil ist nur dann am besten, wenn es vollständig bleibt.

Fehler-FAQ

Häufige Fragen zu fehlgeschlagenen Scraping-Anfragen

Schnelle Antworten für Teams, die das Verhalten der Web Scraping API bewerten: Anfrageformate, JavaScript-Rendering, Proxy-Routing, Credits, Dateien, Sicherheit und Abrechnung.

Schnelle Antworten
SETUP

Zuerst beheben

Einige Fehler sind Probleme mit der Anfrage oder der Kontokonfiguration.

Welche Fehler sollten sofort gestoppt werden?

Fehlerhafte URLs, fehlende URLs, nicht unterstützte Formate, ungültige Schlüssel und inkompatible Ausgabeoptionen sollten korrigiert werden, bevor eine weitere Anfrage gesendet wird.

Warum ist die Validierung vor dem Skalieren wichtig?

Die Validierung verhindert, dass Teams Credits für Anfragen ausgeben, die aufgrund einer falschen Anfrageform nicht erfolgreich sein können.

RETRY

Vorsichtig erneut versuchen

Vorübergehende Fehler benötigen Grenzen und Rückzug.

Welche Fehler können erneut versucht werden?

Timeouts, ausgewählte upstream 5xx-Antworten und einige Ratenlimits können mit begrenztem Rückzug und klarer Protokollierung erneut versucht werden.

Warum nicht alles erneut versuchen?

Wiederholungen beheben keine schlechten Eingaben, nicht unterstützte Formate, blockiertes Zielverhalten, leere App-Schalen oder übergroße Erfassungen.

ESCALATE

Kontrollen ändern

Fügen Sie schwerere Kontrollen hinzu, wenn Beweise zeigen, dass sie helfen.

Wann sollte das Rendering aktiviert werden?

Aktivieren Sie das Rendering, wenn der Quell-HTML keinen nützlichen öffentlichen Inhalt enthält und die gerenderte Seite dies tut.

Wann sollte sich das Routing ändern?

Ändern Sie das Routing, wenn Status, Region, Zugriffsverhalten oder wiederholte Liefernachweise zeigen, dass der Standardpfad nicht ausreicht.

OUTPUT

Überprüfen Sie die Form

Das Antwortformat kann den Fehlermodus ändern.

Kann das Ausgabeformat Fehler verursachen?

Ja. Screenshots, PDFs, JSON, Text, Markdown und HTML haben jeweils unterschiedliche Größen-, Rendering- und nachgelagerte Validierungsprobleme.

Was ist, wenn die Antwort zu groß ist?

Behandeln Sie übergroße Antworten zuerst als ein Problem des Umfangs. Verengen Sie die Erfassung oder wählen Sie eine leichtere Ausgabe, bevor Sie dasselbe Anfrageprofil skalieren.