Actions15
- Screenshot Actions
- Async Job Actions
- Bulk Screenshot Actions
- Compose Actions
- Usage Actions
Bulk Screenshot → Create
AI-generatedSummary
Submits a bulk screenshot job to Allscreenshots for up to 100 URLs, applying shared default capture settings and optional per-URL overrides. Returns the API's job response; it does not download images itself.
Inputs
- urls (required) — URLs to capture, one per line (max 100). Lines are trimmed and blank lines dropped.
- device — Default device preset for all URLs. If set, it is used instead of the custom viewport.
- fullPage — Capture the entire scrollable page (default false).
- darkMode — Emulate dark mode (default false).
- blockCookieBanners — Auto-dismiss cookie banners (default true).
- viewportOptions — Custom width, height and device scale factor, used as defaults.
- outputOptions — Default image format (PNG/JPEG/WebP/PDF) and quality (quality applies to JPEG/WebP).
- waitOptions — Delay (ms), wait-for-selector, wait-until event (domcontentloaded/load/networkidle) and timeout.
- pageModifications — Custom CSS injected into every page before capture.
- blockingOptions — Block ads toggle and Hagezi block level (none to ultimate).
- advancedOptions — Stealth mode (anti-detection).
- actions — Ordered page interactions before capture (click, type, press, hover, select, scroll, wait; max 25). Each can be optional or have its own timeout.
- outputs — Multiple outputs per capture: screenshot, PDF, HTML, Markdown, or JSON extraction via a selector schema. Each can have an ID.
- urlOptions — Per-URL overrides (device, format, full page, dark mode, quality, width/height). The URL must match a line in the URLs list exactly.
- webhookOptions — Webhook URL to be notified when the bulk job completes, plus an optional secret for HMAC-signing the payload.
Output shape
One JSON item per input item containing the API's response for the created bulk job (the job record, typically including its bulk job ID).
The call is asynchronous: no binary data is returned. Use the Bulk Screenshot Get Status operation with the job ID, or a webhook, to track completion. Shared settings are sent as defaults and only per-URL overrides go on individual URLs. With Continue On Fail, errors are returned as {error: message}.
Examples
Example 1: Capture mobile and desktop views of a list of landing pages
URLs: one per line; Device Preset: Desktop HD; Per-URL Overrides: add an iPhone 15 override for the URLs that need a mobile view; Output format WebP.
Example 2: Archive many pages as PDFs and get notified on completion
URLs: list; Output Options format: PDF; Full Page: on; Webhook URL and secret set.
Example 3: Scrape structured data and Markdown from many pages
Outputs: add a Markdown output and a JSON Extraction output with a schema like {"title":{"selector":"h1"}}.