How to Automate Website Screenshots with APITemplate.io in n8n
APITemplate.io’s documented n8n workflow generates PDFs, while its image API renders saved templates. Here’s what each can do—and how to capture live pages instead.
Short answer: The APITemplate.io material documented for n8n does not show how to capture an arbitrary live webpage from a URL as an image. It documents generating PDFs from templates in n8n, while its image API renders JPEG or PNG files from saved templates and JSON overrides. Those are different jobs from taking a screenshot of a live website. APITemplate.io’s API reference and n8n integration guide describe those supported workflows.
This guide explains the distinction, shows the documented PDF workflow shape in n8n, and gives a working live-page screenshot alternative. The APITemplate.io setup below summarizes vendor documentation; it has not been independently executed or validated.
1. Choose the output you need
| Goal | Input | Output | Documented route |
|---|---|---|---|
| Capture a live website | A URL such as https://example.com |
Image of the page as rendered in a browser | Use a screenshot capture service. The cited APITemplate.io material does not establish this capability. |
| Render an image from a reusable design | Template ID and JSON values for template objects | JPEG or PNG generated from the saved template | APITemplate.io template image API |
| Generate a document in n8n | Template ID and data for the template | PDF and a download URL | APITemplate.io n8n node (V1) or HTTP Request node calling the documented V2 PDF endpoint |
If your requirement is specifically “take a screenshot of this page URL,” do not substitute a template image endpoint or PDF endpoint. Neither endpoint’s documented purpose establishes browser capture of that URL.
2. What APITemplate.io documents for n8n: PDF generation
The official n8n guide describes preparing a PDF template, storing the API key in n8n credentials, and then using either the APITemplate.io node or an HTTP Request node. The guide says the built-in node uses V1 and recommends the HTTP Request route for V2’s performance improvements and newer features. Its HTTP example calls the PDF endpoint, so it creates a PDF rather than a webpage screenshot.
Workflow outline
- Create a PDF template in APITemplate.io with the fields your workflow needs, then keep its template ID.
- In n8n, store the APITemplate.io API key in credentials. Do not paste the secret into ordinary workflow data or expressions.
- Add an HTTP Request node for the documented V2 PDF route, or use the vendor node if V1 meets your needs.
- Pass the returned
download_urlto the next node for storage, email, or another workflow action. - For longer-running PDF generation, follow the guide’s asynchronous webhook approach so APITemplate.io can notify an n8n webhook when the file is ready.
HTTP Request node fields
| Setting | Value |
|---|---|
| Method | POST |
| URL | https://rest.apitemplate.io/v2/create-pdf |
| Authentication | Header authentication using the credential value for X-API-KEY |
| Query parameter | template_id set to the saved PDF template ID |
| Body | JSON matching the template and the V2 request schema in the vendor guide |
| Next step | Read download_url from the response and pass it to storage or delivery nodes |
Use the exact request body and field names required by your APITemplate.io template and the current API documentation. The source guide establishes the endpoint, header, template ID query parameter, JSON body, and download URL flow, but this article does not invent a universal JSON payload because template data varies.
n8n describes itself as a platform for connecting applications through APIs and manipulating data with little or no code; its documentation lists cloud, npm, and self-host options. See the n8n documentation for deployment and node configuration details.
3. APITemplate.io image generation is template rendering
APITemplate.io’s API reference also describes generating JPEG or PNG images from a saved template using JSON data and named template-object overrides. That is useful when you want to produce repeatable graphics—such as a social card or personalized graphic—from structured values. The input is template data, not a URL to an arbitrary webpage rendered in a browser.
The reference describes a V1 create endpoint for PDF or image output using a template ID and X-API-KEY, returning a download URL. It is older version-specific documentation. For a current implementation, check the API reference and integration guide together rather than assuming the older V1 details apply to V2.
4. Capture a live webpage from n8n
For a URL-to-image workflow, use an API that explicitly accepts a page URL and returns a browser capture. A typical n8n flow is:
- Choose a trigger: Schedule, Webhook, or another node that supplies the target URL.
- Call the screenshot API with an HTTP Request node, passing the URL and your API credential.
- Configure the response as a file/binary response if the service returns image bytes. If it returns a URL, fetch that URL in a subsequent HTTP Request node.
- Send the binary image to a storage, email, or notification node. Use a deterministic file name when downstream systems should replace prior captures.
- Handle non-success results explicitly: route failed captures to a retry or review branch and retain the response status and diagnostic headers.
The request and response settings depend on the capture service. Do not configure the APITemplate.io PDF endpoint as though it accepted a webpage URL. A live page may also require authentication, a wait condition, a particular viewport, or consent-banner handling; select a service that documents the controls your page needs.
5. Or skip the browser setup
ScreenshotNeo is a website screenshot API and MCP server. One GET request with a URL returns PNG, JPEG, WebP, or PDF. Cookie and consent banners are accepted like a visitor and more than 60 known consent platforms, newsletter popups, and chat widgets can be removed before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, and each response identifies the page verdict and billing state in headers. An MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents and MCP clients.
See the ScreenshotNeo API documentation for parameters and response details.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp
import requests
r = requests.get(
"https://api.screenshotneo.com/v1/shot",
params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"},
timeout=90,
)
r.raise_for_status()
open("shot.webp", "wb").write(r.content)
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);
if (!res.ok) throw new Error(`Screenshot request failed: ${res.status}`);
await Bun.write('shot.webp', res);
In n8n, put the access key in credentials, make an HTTP Request using GET against the API URL, and pass the target URL and key as query parameters. Configure the node to return a file/binary response, then connect its binary output to your storage or delivery node. Follow the docs for output format and other options.
ScreenshotNeo also supports full-page capture with lazy images loaded, CSS-selector element capture, dark mode, 12 device presets and custom viewports, retina scale, PDF page settings, HTML/CSS rendering, custom CSS and JavaScript, click-before-capture, selector hiding, selector/delay/network-idle waits, request and resource blocking, headers, cookies, user agent and Authorization, timezone and geolocation, transparent background, resizing, configurable cache TTL, signed public image links, async jobs with signed webhooks, bulk capture of 100 URLs per call, a usage API, and an OpenAPI specification. Parameters used by other screenshot APIs also work to make migrations easier.
There is no card requirement for 1,000 screenshots per month. Paid plans start at $5 for 3,000; other listed plans are Growth at $15 for 15,000, Pro at $39 for 60,000, Scale at $99 for 250,000, and Business at $249 for 1,000,000. Yearly billing gives two months free, and every feature is available on every plan. Sign up for ScreenshotNeo and get 1,000 screenshots a month free with no card.
6. Reliability, performance, and cost considerations
- Keep outputs distinct: a template-rendered image, a generated PDF, and a browser screenshot have different inputs and downstream uses. Choose the endpoint based on the artifact your workflow needs.
- Plan for asynchronous work: APITemplate.io’s guide describes webhook notification for longer PDF generation. Design the workflow to wait for completion rather than assuming every document is immediately ready.
- Protect credentials: keep API keys in n8n credentials and avoid exposing them in URLs, logs, or exported workflow data.
- Handle downloads deliberately: when an API returns a download URL, pass it to a download step and account for the possibility that the URL is temporary according to the vendor’s current documentation.
- Budget based on current plans: consult each vendor’s current pricing and usage terms before estimating recurring cost. The cited APITemplate.io documentation here does not establish current plan prices or quotas.
- Make retries safe: set a bounded retry policy for transient network or generation failures. Avoid unbounded loops that can duplicate documents or consume API quota.
7. Troubleshooting
| Symptom | Likely cause | What to check |
|---|---|---|
| You received a PDF instead of a webpage image | The workflow called APITemplate.io’s documented PDF endpoint | Use a service whose API explicitly captures a live URL as an image. |
| You received a designed graphic, not a page capture | The image endpoint rendered a saved template | Confirm whether your input should be template-object JSON or a live page URL. |
| APITemplate.io rejects the request | Missing/invalid X-API-KEY, incorrect template ID, or body fields that do not match the template/schema |
Check n8n credential selection, query parameters, and the current endpoint-specific request schema. |
| n8n cannot find the API key | The key was not attached as the expected header credential | Verify the HTTP Request node’s header authentication and that the credential contains X-API-KEY. |
| The next node receives JSON rather than a file | The HTTP Request node is handling the API response as JSON, or the API returned a download URL | Inspect the response shape. Download the URL in a second request, or configure binary/file response handling for direct image bytes. |
| The PDF is not ready when the workflow continues | Generation takes longer than the synchronous path assumes | Use the documented asynchronous webhook pattern for longer jobs. |
| The capture is blank or incomplete | For browser screenshots, the page may still be loading, require consent/authentication, or block automated traffic | Use documented wait, cookie, header, and page-verdict controls from the screenshot service; inspect the returned status before storing the image. |
8. Frequently asked questions
Can APITemplate.io capture a screenshot from any URL in n8n?
The reviewed official documentation does not establish that capability. It documents template-based image generation and a PDF generation workflow. Use a dedicated webpage screenshot API for arbitrary live URLs.
Can I use the APITemplate.io n8n node for the V2 PDF endpoint?
The integration guide says its built-in node uses V1 and recommends an HTTP Request node to call V2.
When should I use APITemplate.io image generation?
Use it when you need to render an image from a saved reusable template populated with JSON values, rather than photograph the rendered state of an existing web page.
Does n8n require its cloud service?
n8n documentation describes cloud, npm, and self-host options. Choose the deployment that fits your operations and consult its current setup documentation.


