Zum Hauptinhalt springen
Piloterr
Zurück zur Bibliothek

API Website Rendering

Render JavaScript-heavy pages in a headless browser and return post-render HTML. Use when Crawler returns empty DOM; escalate to WebUnlocker if bot protection blocks the session.

Aktiv2 Credits = 1 AnfrageGET/v2/website/rendering

Endpunkt-Übersicht

Detaillierte Dokumentation, Preise und Anwendungsbeispiele.

Choosing the right endpointLink to Choosing the right endpoint

Piloterr exposes three complementary ways to fetch a public web page. Pick the lightest engine that works for your target site.

Endpoint Engine Credits Use when
Website Crawler HTTP request (no JavaScript) 1 The HTML you need is already in the first response: blogs, docs, server-rendered catalog pages, sitemaps.
Website Rendering Headless browser (JavaScript executed) 2 Content appears only after JS runs: React/Vue/Angular SPAs, lazy-loaded listings, pages that need wait_for or POST browser_instructions.
Website WebUnlocker Browser + unlock stack 3 Website Rendering or Website Crawler hit bot walls (Cloudflare, DataDome, Akamai, PerimeterX) and the domain is on Piloterr's approved whitelist.

Decision flow

  1. Try Crawler first if you do not need client-side rendering. It is the fastest and cheapest option.
  2. Switch to Rendering when the DOM is empty, prices load asynchronously, or you must wait for a selector / run browser steps.
  3. Escalate to WebUnlocker only for hardened retail or marketplace domains that block normal browser traffic. Whitelist approval is required before production use.

See also: Website Scraping guide.

OverviewLink to Overview

Website Rendering loads the URL in a managed headless browser, executes JavaScript, waits for the DOM to settle, and returns the fully rendered HTML. Use it when Website Crawler returns a shell page or missing prices because content is injected client-side.

Rendering handles most dynamic sites and light anti-bot friction. When Cloudflare Enterprise, DataDome, or Akamai still block the session, escalate to Website WebUnlocker (whitelist required).

Costs 2 credits per successful call.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/website/rendering?query=https://example.com&wait_in_seconds=3

POST is supported when you need browser_instructions (scroll, click, fill forms before extraction).

ParametersLink to Parameters

Parameter Type Required Description
query string yes Public URL with http:// or https://
wait_in_seconds integer no Extra wait after load (0–30 seconds)
wait_for string no CSS/XPath selector to wait for before returning HTML
block_ads boolean no Block ad requests during render. Default false
timeout integer no Max seconds to wait for page load. Default 30
browser_instructions array no POST only: automation steps before capture

ResponseLink to Response

Field Description
Response body HTML after JavaScript execution
Situation Endpoint
Static HTML, no JS needed Website Crawler (1 credit, faster)
Bot wall on whitelisted retail domain Website WebUnlocker
PNG capture instead of HTML Website Screenshot

NotesLink to Notes

  • Domain filtering may apply. Contact Piloterr support to whitelist production targets when needed.
  • Combine wait_for with timeout on slow SPAs and infinite-scroll listings.
  • Prefer Crawler when a quick test shows complete HTML without JS.

Main use casesLink to Main use cases

  • Scrape React, Vue, or Angular marketplaces and dashboards
  • Wait for lazy-loaded product grids or search results
  • Run multi-step flows (accept cookies, open tab, scroll) via POST instructions
  • Collect HTML from pages that fail with plain HTTP crawling

Verwandte APIs

Erweitern Sie Ihre Datenmöglichkeiten mit diesen ergänzenden Tools.

Website Antibot/v2/website/antibot

Erkennen Sie den Anti-Bot-Schutz einer Website vor dem Scraping. Vendor, Konfidenz und Hinweise in einem Aufruf.

GET1 Credit = 1 AnfrageAktiv
Website Crawler (POST)/v2/website/crawler

Webseiten und API-Endpunkte per URL crawlen und strukturierte JSON-Antworten per POST abrufen.

POST1 Credit = 1 AnfrageAktiv
Website Crawler/v2/website/crawler

Fetch public pages with fast HTTP crawling (no JavaScript). Best first choice for static or server-rendered HTML; use Rendering or WebUnlocker when JS or anti-bot blocks you.

GET1 Credit = 1 AnfrageAktiv
Website Email Phone Extractor/v2/website/email_phone_extractor

Extrahieren Sie E-Mails und Telefonnummern von Websites für umfassende Kontaktdaten, einschließlich Social-Media-Profile auf über 12 Plattformen.

GET1 Credit = 1 AnfrageAktiv
Website Rendering Instructions (POST)/v2/website/rendering

Führen Sie Browser-Automatisierungsanweisungen (scroll, scroll_to_bottom) während des Headless-Renderings aus, um Lazy-Loading-Inhalte auszulösen, Bot-Erkennung zu umgehen und dynamisch geladene Seiten zu scrapen.

POST2 Credits = 1 AnfrageAktiv
Website Screenshot/v2/website/screenshot

Screenshot API mit Browser-Rendering: erfasst Webseiten als PNG/JPEG/WebP oder PDF für Previews, QA, Reporting, Monitoring und Archivierung ohne Headless-Infrastruktur.

GET2 Credits = 1 AnfrageAktiv
Website Technology/v2/website/technology

Identifizieren Sie die Technologien hinter jeder Website CMS, Frameworks, Analytics, CDN, Hosting: für Wettbewerbsanalyse und technologische Einblicke.

GET1 Credit = 1 AnfrageAktiv
Website WebUnlocker/v2/website/webunlocker

Bypass advanced anti-bot systems (Cloudflare, DataDome, Akamai, PerimeterX) on whitelisted domains. Combines browser rendering and unlock tooling; use after Crawler and Rendering fail.

GET3 Credits = 1 AnfrageAktiv
Website WebUnlocker (POST)/v2/website/webunlocker

Senden Sie POST-Anfragen an freigeschaltete Websites oder APIs über WebUnlocker, um fortschrittlichen Anti-Bot-Schutz zu umgehen und die Upstream-Antwort abzurufen.

POST3 Credits = 1 AnfrageAktiv

Bereit loszulegen?

Ihre Web-Scraping-API ist nur einen Klick entfernt. Starten Sie mit +500 Credits, ohne Infrastruktur einrichten zu müssen, ohne Proxys zu verwalten und ohne Kreditkarte.

  • +500 Credits
  • Keine Kreditkarte erforderlich
  • Alle Endpunkte enthalten