Allscreenshots icon

Allscreenshots

Capture and manage website screenshots with Allscreenshots API

Actions15

Screenshot → Capture Async

AI-generated

Summary

Starts an asynchronous screenshot capture job on the Allscreenshots API for a URL and returns the job response immediately, without waiting for the capture to finish. Optionally notifies a webhook when the result is ready.

Inputs

  • url (required) — The webpage URL to capture.
  • responseType — Binary, Base64 (JSON) or URL (JSON). Binary is the default and is not sent to the API; base64 and url are sent as responseType.
  • device — Device preset (desktop, laptop, iPhone, iPad, Pixel, Galaxy, social-card sizes, etc.). Overrides custom viewport.
  • fullPage — Capture the whole scrollable page instead of just the viewport.
  • darkMode — Emulate prefers-color-scheme: dark.
  • blockCookieBanners — Dismiss or block cookie banners (default true).
  • viewportOptions — Custom width, height (100-4096) and device scale factor (1-3). Ignored if a device preset is chosen.
  • outputOptions — Format (PNG, JPEG, WebP, PDF), quality (JPEG/WebP only) and an element CSS selector to capture.
  • waitOptions — Delay in ms, wait-for-selector, wait-until event (domcontentloaded, load, networkidle) and page-load timeout.
  • pageModifications — Custom CSS to inject and comma-separated selectors to hide.
  • blockingOptions — Block ads and a Hagezi blocklist level (light to ultimate). A level of none is not sent.
  • advancedOptions — Stealth mode, full-page mode (stitch or native), freeze fixed elements, scroll interval, max height and max sections.
  • actions — Ordered page steps run before capture: click, type, press key, hover, select, scroll, wait. Each can be optional and have its own timeout.
  • outputs — Multiple outputs from one capture: screenshot, PDF, HTML, Markdown or JSON extraction by selector schema. Each can have an ID for later retrieval.
  • session — Cookies to set before loading the page, for authenticated captures.
  • webhookUrl — URL notified when the screenshot is ready.
  • webhookSecret — Secret used to HMAC-sign the webhook payload (X-Webhook-Signature).

Output shape

One JSON item per input item containing the API's response to POST /v1/screenshots/async (the async job details). No binary data is attached.

The response fields are not defined in the node source. Use the Async Job resource (Get Status, Get Result) with the returned job ID to poll and download results; for multi-output jobs, pass an output ID to Get Result. With Continue On Fail enabled, errors are returned as {error: message} for that item.

Examples

Example 1: Capture a full-page PDF of a long page without blocking the workflow

URL set, Full Page on, Output Options format = PDF; then use Async Job > Get Result with the returned job ID.

Example 2: Get a Markdown and a screenshot of an article in one job, notified by webhook

Outputs: add Markdown (id 'md') and Screenshot (id 'shot'); set Webhook URL and Webhook Secret.

Example 3: Capture a logged-in page after interacting with it

Session Cookies with the auth cookie, Page Actions: click '#tab-reports' then wait for selector '.loaded'.

Links

Discussion