API Website Rendering Instructions (POST)

ÜberblickLink to Überblick

Die Website Rendering Instructions API erweitert das Headless-Browser-Rendering um einen browser_instructions-Parameter, mit dem Sie Scroll-Aktionen und andere Browsersteuerungen vor der HTML-Extraktion programmatisch ausführen können. Unverzichtbar für Lazy-Loading-Inhalte, Infinite-Scroll-Seiten oder menschenähnliche Navigation.

Unterstützte Instruktionstypen:

• scroll — scrollt die Seite um eine bestimmte Pixelanzahl
• scroll_to_bottom — scrollt automatisch ans Ende der Seite

SchnellstartLink to Schnellstart

POST https://api.piloterr.com/v2/website/rendering
Content-Type: application/json

{
  "query": "https://www.comparably.com/companies/airbus",
  "wait_for": "#ng-state",
  "browser_instructions": [
    { "type": "scroll", "x": 0, "y": 4115, "wait_time_s": 5 }
  ]
}

ParameterLink to Parameter

AntwortfelderLink to Antwortfelder

HinweiseLink to Hinweise

• Dieser Endpunkt kostet 2 Credits pro Anfrage
• Domain-Filterung wird aus Sicherheitsgründen angewendet
• Anweisungen werden sequenziell ausgeführt; schlägt eine fehl, werden folgende fortgesetzt
• Erhöhen Sie timeout bei langen kumulierten Instruktionsdauern

HauptanwendungsfälleLink to Hauptanwendungsfälle

• Lazy-Loading-Inhalte und Infinite-Scroll-Bereiche vor der Extraktion auslösen
• Menschenähnliches Scroll-Verhalten simulieren, um Bot-Erkennung auf JavaScript-lastige Seiten zu umgehen
• Dynamisch gerenderte Inhalte (Bewertungen, Kommentare, Tabellen) laden, die erst nach Interaktion erscheinen
• Mehrstufige Browser-Navigation auf SPAs automatisieren, um tiefe Seitenzustände zu erreichen