Description

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)

1. Go to Settings > Community Nodes
2. Click Install
3. Enter @allscreenshots/n8n-nodes-allscreenshots
4. Click Install

Manual Installation

npm install @allscreenshots/n8n-nodes-allscreenshots

Authentication

1. Sign up at allscreenshots.com
2. Go to Dashboard > API Keys
3. Create a new API key
4. In n8n, go to Settings > Credentials > Add Credential
5. Search for “Allscreenshots API”
6. 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:

1. Add the Allscreenshots Trigger node and copy its Production URL.
2. Paste that URL into the Webhook URL option of your Screenshot (async), Bulk,
Compose, or Schedule request.
3. (Optional) Set the same Webhook Secret on both the request and the trigger to
verify the X-Webhook-Signature header.

#### 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

1. Add an Allscreenshots node
2. Select Resource: Screenshot
3. Select Operation: Capture
4. Enter the URL to capture
5. Configure options as needed
6. Execute

Bulk Screenshots with Notifications

1. Add an Allscreenshots Trigger node with Event Bulk Completed, and copy its
Production URL.
2. 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
3. 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

1. Add an Allscreenshots node
– Resource: Compose
– Operation: Create
– Enter the same URL multiple times
– Layout: Grid
2. 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.

Resources

• Allscreenshots Website
• API Documentation
• n8n Community Nodes

License

MIT