Render a screenshot

Sets the Authorization header - the common case, spelled once. An explicit Authorization in headers wins over this.

Drop requests to known ad and tracker networks before they load. Stopped as network requests rather than hidden afterwards, so the page never spends time fetching them.

Hide common consent banners, and undo the scroll lock they set - without which a full-page capture is one viewport tall.

Hidden, not accepted. Clicking "accept" would be a decision made on the site owner's behalf and recorded as theirs.

Custom stylesheet, at most 65536 UTF-8 bytes. Applied after normal load/wait conditions and built-in hiding, before script, actions, settling and capture. Supports screenshots and PDFs, including @media print rules. Malformed stylesheet syntax is a 400 bad_request; Chromium determines supported properties and values.

Pixel density. 2 is retina: the same CSS size at twice the pixels.

Force a fresh render instead of serving a cached one. Always billable. Excluded from the cache key, so repeated fresh requests do not collide.

JavaScript statements executed inside the target page's main-frame context after load/wait conditions and css, before actions and capture. Runs as an async function body: use await or return a promise for asynchronous work. Completion is awaited; return values are discarded. At most 16384 UTF-8 bytes and 5000 ms execution, further bounded by the remaining timeout_ms budget. Syntax errors, execution failures and timeouts return 422 render_failed with a sanitized message. Supports screenshots and PDFs; no browser-session or Playwright/Puppeteer APIs are exposed.

Per-render timeout. Clamped to the service maximum - it can lower the ceiling but not raise it.

Overrides the user agent, including any set by device.

Wait for this element before capturing. Fails the render if it never appears, rather than returning a half-drawn page.

When the page counts as ready. networkidle waits for traffic to stop and is bounded by the render timeout, because a page with polling never truly idles.

Render with prefers-color-scheme: dark.

Extra settle time after load. Ironfang Render watches the page and captures when it stops changing, so this is rarely needed - use it for content that arrives on a timer, which quiescence cannot anticipate. Capped at ten seconds.

Capture as a phone or tablet rather than a desktop window that happens to be narrow. Sets the viewport, the device pixel ratio, touch, and a matching mobile user agent together - width alone gets media queries right and everything else wrong.

An explicit width or height still wins, so a preset can be used for the density and user agent while overriding the size.

PNG is lossless and the default. WebP is typically a fraction of the size for the same picture, which is what matters when the output is served to browsers or social crawlers.

Capture the whole scrollable page.

Cap a full_page capture at this many pixels. An infinite-scroll page has no natural end, so 20000 applies when none is given, and is also the most that can be asked for.

scroll walks a full_page capture down before taking it, a viewport at a time with overlap, so content a page loads only as it comes into view - loading=lazy images, IntersectionObserver loaders - is in the picture without a script of your own. Each step waits up to 750 ms for the images it exposed; the walk then returns to the top and waits up to 2 s for the images inside the capture. The whole pass takes at most 10 s (less when timeout_ms leaves less, keeping 3 s for the capture), at most 60 steps, and never goes below full_page_max_height, so an infinite feed ends where the capture is cut.

The page keeps its authored layout: the capture is taken from the top, so a sticky header appears once, at the top, and a fixed element where it sits in the first viewport. What the pass did is in the X-Ironfang-Warnings header and a job's diagnostics.readiness; a budget that runs out is a warning on a successful capture, not a failure. Omitted, the capture is taken as it always has been. Requires full_page.

Viewport height. Ignored when full_page is set.

Markup to render. Mutually exclusive with url.

Transparent background instead of the page's own. Ignored for jpeg, which has no alpha channel.

Quality for the lossy formats, jpeg and webp. Ignored for PNG.

CSS selector of a single element to capture instead of the viewport.

Page to capture. Mutually exclusive with html.

Viewport width in pixels.