ScreenshotOne icon

ScreenshotOne

Render PDFs, screenshots, scrolling screenshots, and short videos using ScreenshotOne

Overview

This node integrates with the ScreenshotOne service to render visual content from various input sources. It supports generating full page screenshots, PDFs, short videos, scrolling screenshots, and standard screenshots from URLs, raw HTML, or Markdown content.

Common scenarios where this node is beneficial include:

  • Automatically capturing website snapshots for monitoring or archiving.
  • Generating PDF reports from web pages or custom HTML/Markdown content.
  • Creating short video previews of web pages or dynamic content.
  • Producing scrolling screenshots that capture entire long pages.
  • Converting Markdown documentation into visual formats.

For example, a user can input a URL and request a full page screenshot in JPG format with a delay to ensure all dynamic content loads before capture. Alternatively, they can provide Markdown text to generate a PDF report.

Properties

Name Meaning
Source The type of input to render. Options: URL, HTML, Markdown.
URL The URL to render (required if Source is URL).
HTML The HTML content to render (required if Source is HTML).
Markdown The Markdown content to render (required if Source is Markdown).
Format Image format for screenshots/full page screenshots. Options: PNG, JPG, WEBP.
Full Page Scroll Delay (Milliseconds) Delay in milliseconds before capturing full page screenshot to allow page loading (minimum 400 ms).
Cache Enable or disable caching for the request.
Cache TTL (Seconds) Time to live for cache in seconds (minimum 14400 seconds = 4 hours, max 2592000 seconds = 30 days).
Cache Key Custom cache key string to identify cached requests.

Note: Some properties like "Format" are only shown when the operation is "full_page" or "screenshot".

Output

The node outputs an array of items, each containing a json field with the response data from the ScreenshotOne API. This typically includes metadata about the rendered content and a URL or base64 encoded data representing the generated image, PDF, or video.

If the output contains binary data (e.g., images or videos), it will be included as part of the JSON response or accessible via URLs provided by the API.

Dependencies

  • Requires an API key credential for the ScreenshotOne service.
  • The node calls ScreenshotOne's API endpoints (take for screenshots/PDFs and animate for videos).
  • No additional environment variables are required beyond the API key credential.

Troubleshooting

  • Invalid or missing API key: The node requires a valid API key credential. Ensure the API key is correctly configured in n8n credentials.
  • Unsupported source input: If the selected source does not match the provided input (e.g., selecting URL but providing HTML), the node may fail. Verify the source matches the input property.
  • Timeouts or delays: For full page screenshots, insufficient scroll delay might cause incomplete captures. Increase the "Full Page Scroll Delay" if the page has heavy dynamic content.
  • Cache issues: If caching is enabled but results do not update, try clearing the cache or using a unique cache key.
  • Unsupported format or operation: Selecting incompatible formats or operations may cause errors. Use only supported combinations as per the properties.

Links and References

Discussion