Package Information
Documentation
n8n-nodes-allscreenshots
This is an n8n community node for Allscreenshots - a powerful API for capturing and managing website screenshots at scale.
n8n is a fair-code licensed workflow automation platform.
Installation
Community Nodes (Recommended)
- Go to Settings > Community Nodes
- Click Install
- Enter
@allscreenshots/n8n-nodes-allscreenshots - Click Install
Manual Installation
npm install @allscreenshots/n8n-nodes-allscreenshots
Authentication
- Sign up at allscreenshots.com
- Go to Dashboard > API Keys
- Create a new API key
- In n8n, go to Settings > Credentials > Add Credential
- Search for "Allscreenshots API"
- Enter your API key
Nodes
This package includes two nodes:
Allscreenshots
The main node for capturing and managing screenshots.
Resources
| Resource | Description |
|---|---|
| Screenshot | Capture screenshots synchronously or asynchronously |
| Async Job | Manage async screenshot jobs (status, result, cancel) |
| Bulk Screenshot | Capture up to 100 URLs in a single operation |
| Compose | Combine multiple screenshots into one image |
| Usage | Check API usage and quota status |
Allscreenshots Trigger
Webhook receiver node for notifications when jobs complete.
Allscreenshots does not register webhooks via the API — instead, each request carries
its own webhookUrl. To use this trigger:
- Add the Allscreenshots Trigger node and copy its Production URL.
- Paste that URL into the Webhook URL option of your Screenshot (async), Bulk,
Compose, or Schedule request. - (Optional) Set the same Webhook Secret on both the request and the trigger to
verify theX-Webhook-Signatureheader.
Supported Events
- Screenshot Completed (
JOB_COMPLETED) - Screenshot Failed (
JOB_FAILED) - Bulk Completed (
BULK_COMPLETED) - Schedule Executed (
SCHEDULE_EXECUTED) - Schedule Failed (
SCHEDULE_FAILED)
Operations
Screenshot
| Operation | Description |
|---|---|
| Capture | Take a screenshot synchronously (returns image) |
| Capture Async | Start an async capture job (returns job ID) |
Key Options:
- Device presets (iPhone, Pixel, Galaxy, iPad, Surface, social-media sizes)
- Custom viewport (width, height, scale)
- Output format (PNG, JPEG, WebP, PDF)
- Response type (binary file, base64 JSON, or hosted URL)
- Full page capture with tuning (native/stitch, freeze fixed, max height/sections)
- Element selector
- Wait options (delay, selector, network idle)
- Page modifications (dark mode, custom CSS, hide elements)
- Ad & cookie banner blocking, stealth mode
- Page actions — click, type, press, hover, select, scroll, wait before capture
- Outputs — produce screenshot, PDF, cleaned HTML, Markdown, or structured JSON
extraction from a single capture - Session cookies — authenticate captures by injecting cookies
Async Job
| Operation | Description |
|---|---|
| Get Status | Check job completion status |
| Get Result | Download the screenshot |
| Cancel | Cancel a pending job |
| List All | List all jobs with optional filters |
Bulk Screenshot
| Operation | Description |
|---|---|
| Create | Start a bulk job (up to 100 URLs) |
| Get Status | Check bulk job progress |
| List All | List all bulk jobs |
| Cancel | Cancel a bulk job |
Bulk Create supports full default options (device, viewport, format, wait, blocking,
stealth, page actions, outputs) plus per-URL overrides matched by URL, and webhook
notifications.
Compose
| Operation | Description |
|---|---|
| Create | Compose multiple screenshots into one |
| Get Status | Check compose job status |
| List Jobs | List all compose jobs |
Source modes: multiple URLs, or a single URL captured across several variants
(viewports/devices) for responsive comparisons.
Layout Options:
- Auto (intelligent layout selection)
- Grid
- Horizontal / Vertical
- Masonry (Pinterest-style)
- Mondrian (artistic layout)
- Partitioning (space-filling)
Styling: columns, spacing, padding, background, alignment, max width/height,
thumbnail width, and per-screenshot labels.
Usage
| Operation | Description |
|---|---|
| Get Full Stats | Complete usage statistics with history |
| Get Quota | Current quota status |
Usage Examples
Basic Screenshot
- Add an Allscreenshots node
- Select Resource: Screenshot
- Select Operation: Capture
- Enter the URL to capture
- Configure options as needed
- Execute
Bulk Screenshots with Notifications
- Add an Allscreenshots Trigger node with Event Bulk Completed, and copy its
Production URL. - Add an Allscreenshots node
- Resource: Bulk Screenshot
- Operation: Create
- Enter URLs (one per line)
- Under Webhook Options, paste the trigger's Production URL into Webhook URL
- Connect the trigger node to your notification service (Slack, Email, etc.)
The trigger fires when Allscreenshots POSTs the completion event to that URL.
Compare Multiple Device Views
- Add an Allscreenshots node
- Resource: Compose
- Operation: Create
- Enter the same URL multiple times
- Layout: Grid
- Configure different device presets for each
Device Presets
The node includes the device presets supported by the API:
Mobile:
- iPhone SE, XR, 12, 12 Pro Max, 14, 14 Pro Max, 15, 15 Pro Max
- Samsung Galaxy S21, S23
- Google Pixel 5, 7, 7 Pro
Tablet:
- iPad, iPad Mini, iPad Pro 11", iPad Pro 12.9"
- Galaxy Tab S7, Surface Pro 7
Desktop / Laptop:
- Desktop HD (1920×1080), Desktop Large (2560×1440), Desktop Retina
- Laptop (1440×900), Laptop Retina
Social media:
- Facebook OG, Twitter Card, LinkedIn Post
- Instagram Square / Portrait / Story
Development
For local development, testing, and publishing instructions, see CONTRIBUTING.md.