Website Rendering Instructions (POST) API

OverviewLink to Overview

The Website Rendering Instructions API extends the headless browser rendering capability with a browser_instructions parameter, allowing you to programmatically control scrolling and other browser actions before extracting the rendered HTML. This is essential for triggering lazy-loaded content, infinite scroll pages, or simulating human-like navigation to avoid detection.

Supported instruction types:

• scroll — scroll by a precise number of pixels (horizontal and/or vertical)
• scroll_to_bottom — automatically scroll to the bottom of the page

QuickstartLink to Quickstart

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 }
  ]
}

ParametersLink to Parameters

Browser Instructions — scrollLink to Browser Instructions — scroll

Browser Instructions — scroll_to_bottomLink to Browser Instructions — scroll_to_bottom

Response fieldsLink to Response fields

NotesLink to Notes

• This endpoint costs 2 credits per request
• Domain filtering is applied. Contact support to whitelist your target domain
• Instructions are executed sequentially; if one fails, subsequent ones continue
• Increase timeout when instructions have significant cumulative durations

Main use casesLink to Main use cases

• Trigger lazy-loaded images and infinite scroll sections before extracting content from product listing or news feed pages
• Simulate human-like scrolling behavior to bypass bot detection systems on JavaScript-heavy websites
• Load dynamically rendered content (reviews, comments, data tables) that only appears after user interaction
• Automate multi-step browser navigation on SPAs to reach deep page states before scraping