Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use Puppeteer’s page.screenshot() to render and capture the page, then upload the resulting image with Cloudinary’s Node.js SDK. For the simplest workflow, save the screenshot to a file and call cloudinary.uploader.upload(). If you do not need a temporary file, send screenshot bytes through cloudinary.uploader.upload_stream(). Keep Cloudinary’s API secret on the server.

What you need

  • A Node.js project with Puppeteer and the Cloudinary Node.js SDK installed.
  • A Cloudinary account’s cloud name, API key, and API secret, configured as server-side environment variables.
  • The URL you want to capture. If this code will accept URLs from users, validate or allowlist destinations and apply network controls to reduce server-side request risks.

The examples below use the Cloudinary SDK’s v2-style API. Check the current Cloudinary Node.js SDK documentation for installation and module syntax appropriate to your project.

Capture a page and upload the image file

This version writes a PNG locally and uploads its path. It is easy to inspect or reuse the image before uploading.

  1. Import Puppeteer and Cloudinary, and configure the SDK from server-side environment variables.

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    #1 Best Overall
    Sale
    ACEMAGIC K1 Mini PC AMD Ryzen 7330U 16GB 256 SSD 4 Cores 8 Threads 4.3GHz
    • [AMD Ryzen 3 Pro 7330U, which is more powerful than the N150/3500U] - ACEMAGIC Mini PC is powered by Latest Processor AMD Ryzen 7330U(4Cores/8Threads, BASE 2.3GHz, MAX TO 4.3GHz) , delivers more than 28% higher performance than N150(Reference from PassMark). Performance at least +40%, GPU at least +23% compared with the previous CPU - N95/N100/3300U. Remarkably power-efficient at 28W, it outperforms its predecessors, even rivaling some mainstream mobile processors from the past
    • [K1 Mini Computer - Meet Your Second PC] - Next-Gen Light Office Mini PC comes pre-installed with the Win11 Pro system, which is intelligent, secure, and efficient. Versatile Connectivity: 10M/100M/1000M RJ45 Gigabit Ethernet Port *1, USB3.2 Type-A Port*6, USB3.2 Gen2 Type-C (10Gbps Data Transfer+DP1.4)×1, HDMI 2.0*1, DP 1.4*1, DC IN ×1, 3.5mm Audio Jack*1. All-New Built-in Power Supply devise Only one cable is needed for power supply, no external adapter is required, keep the desktop neat and clean. Whether it’s for business, family entertainment, school, research, or social media, this mini PC has your needs covered!
    • [Large Storage Capacity, Easy Expansion] - Mini Computer K1 is equipped with a 16GB LPDDR4 3200MT/S (non‑expandable memory) and a 256GB M.2 2280 SSD, which allows the small PC to run several high performance operations simultaneously. The LPDDR4 memory delivers faster data transfer speeds for snappier multitasking and responsive performance. The Ryzen micro desktop offers fast data reading, writing, and storage capabilities, ensuring smooth application running. If you want more storage space, you can also add M.2 NVMe PCIe 3.0 SSD or M.2 SATA SSD to expand storage up to 2TB. This means you can easily store and access a large amount of files, media, and data
    • [Sleek Chassis & High efficiency cooling system] - The portable mini pc features a Silver-toned Body and can be stored in a bag and carried with you at any time, ideal for business trips. Save space by super mini size(5x5x1.6 inch) and a VESA mount to install it on wall or monitors. Advanced Axial Fan & Internal Cooling Technology are practically silent at light load and even under load, the fans remain fairly quiet. Minimal or inaudible fan noise is perfect for concentrating on the task at hand!
    • [WiFi 5&Bluetooth 4.2-Simply Compatible]- ACE Win11 Small PC have reliable and stable wireless connection, opening websites in seconds, watching movies without buffering and downloading files smoothly. Built-in Bluetooth enables you to connect multiple wireless devices such as mice, keyboard, headset, monitoring equipment, printer, monitor, TV and so on. High-speed wireless connection technology, reliable and efficient transmission speed, providing a faster internet experience for browsing and streaming
  2. Launch a browser, navigate to the target page, and capture it with page.screenshot().

  3. Upload the saved path with cloudinary.uploader.upload(), then use the returned secure_url and asset metadata.

const puppeteer = require('puppeteer');
const cloudinary = require('cloudinary').v2;

cloudinary.config({
  cloud_name: process.env.CLOUDINARY_CLOUD_NAME,
  api_key: process.env.CLOUDINARY_API_KEY,
  api_secret: process.env.CLOUDINARY_API_SECRET,
});

async function captureAndUpload(url) {
  let browser;

  try {
    browser = await puppeteer.launch();
    const page = await browser.newPage();

    await page.goto(url, { waitUntil: 'networkidle2' });
    await page.screenshot({ path: 'page.png', type: 'png' });

    const result = await cloudinary.uploader.upload('page.png', {
      resource_type: 'image',
    });

    return {
      secureUrl: result.secure_url,
      publicId: result.public_id,
      format: result.format,
    };
  } finally {
    if (browser) await browser.close();
  }
}

captureAndUpload('https://example.com')
  .then((asset) => console.log(asset))
  .catch((error) => console.error('Capture or upload failed:', error));

Replace https://example.com with the page to capture. Puppeteer’s screenshot guide shows the same basic sequence of launching, navigating, and calling page.screenshot(): Puppeteer screenshots. The Cloudinary upload response includes a secure delivery URL and asset information: Cloudinary Node.js image and video upload.

Choose a navigation wait condition for the site

waitUntil: 'networkidle2' waits for network activity to settle according to Puppeteer’s navigation condition, but it does not guarantee that every delayed image, animation, or client-rendered element is ready. Sites that maintain long-running network requests may also make a network-idle condition unsuitable. Validate the condition against the page being captured; when needed, wait for a known selector or an explicit delay before taking the screenshot.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
KAMRUI Essenx E2 Mini PC, AMD Ryzen 5 3500U(4 Cores, 8 Threads, Up to 3.7GHz), 16GB DDR4(Expandable) 256GB M.2 SSD Micro PC, HDMI+DP Dual 4K@60Hz Display Home/Business/Office Mini Desktop Computers
  • 【Ryzen 5 3500U Processor】KAMRUI Essenx E2 Mini PC is equipped with AMD Ryzen 5 3500U (4-cores/8-threads, up to 3.7GHz) with integrated Radeon Vega 8 Graphics(1200MHz, 8 Core). The 3500U CPU operates at a base frequency of 2.1 GHz and a Boost frequency of 3.7 GHz. This DDR supports upgradable up to 32GB, SSD supports up to 2TB.(NOT INCLUED), KAMRUI E2 3500U Mini PC is ideal for light office work and home entertainment. KAMRUI E2 3500U is more than 35% more powerful and smoother in operation than the Intel N150, 33% faster than Intel N95, 28% performance boost over Intel i3-10110U, and 42% stronger processing power than AMD Ryzen 3 3200U.
  • 【16GB DDR4 & 256GB SSD】The KAMRUI E2 mini computers is equipped with 16GB DDR4(Expandable up to 32GB) for faster multitasking and smooth application switching. 256GB M.2 SSD ensures fast startup times,fast file transfers and plenty of storage space,eliminating slow loading times and ensuring fast responsiveness.Storage space can RAM supports up to 32 GB, SSD supports up to 2TB (Not included)make file storage easier.
  • 【4K Dual Display & USB 3.2 Type-A Port】KAMRUI E2 3500U mini desktop pc is equipped with an HDMI 2.0+DP 1.4 interfaces for faster transmission, Support Dual 4K@60Hz Display, E2 mini desktop computers is ideal for visual home entertainment, home office, conference rooms, etc. USB3.2 Gen1 Type-A Port×2 with a transfer speed of up to 5Gbps (10 times faster than USB 2.0) for efficient data transfer. The RJ45 1000M Gigabit Ethernet Port ensures a stable network connection.
  • 【WiFi+Bluetooth stable connection】The Kamrui E2 micro pc have reliable and stable wireless connection, open websites in seconds, watch movies without buffering and download files smoothly, connect your monitor from WiFi or Ethernet, use a wireless keyboard and mouse through bluetooth, which will be powerful workstation for you.
  • 【Versatile Ports】This KAMRUI E2 Small pc is equipped with HDMI 2.0×1(4K@60Hz)、DP1.4×1(4K@60Hz)、Gigabit Ethernet Port (RJ45, 10/100/1000Mbps) ×1、USB3.2 Gen1 Type-A Port×2(5Gbps)、USB2.0 Type-A Port×2、3.5mm Audio Jack ×1、DC In ×1、Power Button ×1

Capture an element instead of the whole page

When the artifact should be one component—such as a chart or card—locate it and call ElementHandle.screenshot() rather than capturing the page. The resulting file can be passed to the same Cloudinary upload call.

const element = await page.waitForSelector('.report-card');
if (!element) throw new Error('Report card was not found');
await element.screenshot({ path: 'report-card.png', type: 'png' });

const result = await cloudinary.uploader.upload('report-card.png', {
  resource_type: 'image',
});
console.log(result.secure_url);

See the Puppeteer screenshot guide for page and element capture methods.

Upload screenshot bytes without a temporary file

page.screenshot() returns image bytes when called without a path. Convert those bytes to a Node.js Buffer and end Cloudinary’s upload stream with it:

const screenshot = await page.screenshot({ type: 'png' });

const uploaded = await new Promise((resolve, reject) => {
  const stream = cloudinary.uploader.upload_stream(
    { resource_type: 'image' },
    (error, result) => {
      if (error) return reject(error);
      resolve(result);
    }
  );

  stream.end(Buffer.from(screenshot));
});

console.log(uploaded.secure_url);

This combines Puppeteer’s screenshot-byte output with Cloudinary’s stream upload API. Confirm the module imports and SDK usage against the versions installed in your project. References: Puppeteer Page.screenshot() API and Cloudinary Node.js upload.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
GMKtec G3S Mini PC Computers Intel N95 Processor (Turbo 3.4GHz)
  • 12th INTEL ALDER LAKE N95 PROCESSOR - The G3S mini pc uses the 12th Intel N95 CPU 4 Core 4 Threads 6MB cache, burst speed up to 3.4GHz. Compared with (N100/N5105/N5100/N5095), the N95 offers an overall performance improvement of 36%. Ideal for routine tasks, office work and home entertainment,which is more convenient than traditional desktop pc
  • 8GB RAM MEMORY & 256GB SSD STORAGE - GMKtec Nucbox G3S mini pc is prebuilt with 8GB DDR4 RAM, you will enjoy a speedier experience with Built-in 256GB M.2 2242 SSD Hard Drive. Our mini desktop pc boots up in seconds, work on multiple browser tabs, software applications and quickly transfers files
  • RICH INTERFACE - Nucbox G3 Plus mini computer is equipped with USB 3.2, up to 10Gbps/S, HDMI(4K@60Hz)×2, 3.5mm Audio Jack. Supports WiFi 5, and Gigabit Ethernet RJ45 1000MbE network connectivity, Bluetooth 5.0. This Mini PC supports multiple device connection and can be used with servers, monitoring equipment, office equipment, displays, projectors, televisions, etc
  • 4K DUAL SCREEN DISPLAY - Mini desktop computer is equipped with upgraded Intel Graphics(max 1000MHz), supports 4K video playback and AV1 decoding, connect the pc with a projector as a home theatre, enjoy a variety of entertainments. Two HDMI 2.0 ports allows you to multi-task efficiently on two 4K@60Hz displays
  • WiFi5 & BT5.0 - Built-in Bluetooth 5.0 enables you to connect multiple wireless devices such as mice, keyboard, monitoring equipment, printer and monitor. High-speed wireless connection technology, reliable and efficient transmission speed, providing a faster internet experience for browsing and streaming. Small pc supports Wake On LAN, PXE Boot, RTC Wake and Auto Power On, ideal to use as a server

Which capture and upload path should you use?

Decision Option Useful when
Capture scope Page.screenshot() for the page; ElementHandle.screenshot() for a selected element You need either the full page or one specific component.
Screenshot handling Save to a file, then upload the path; or keep bytes in memory and send them through upload_stream() A file is convenient to inspect or retain; bytes avoid creating a temporary screenshot file.
Cloudinary upload uploader.upload() for a local path; uploader.upload_stream() for byte or stream workflows Choose based on how your application produces and handles the image.

Keep credentials and browser work on the server

Do not put api_secret in browser-side JavaScript or ship it to users. Cloudinary’s upload documentation says the API secret must remain private. Keep authenticated uploads on the server, or use a correctly configured unsigned upload preset if that is appropriate for your application’s security and upload policy.

In a production service, close the browser in a finally block as in the example. That way, navigation, screenshot, or upload errors do not skip browser cleanup.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshooting

The screenshot is blank or missing page content

  • Check that navigation completed and that the URL is correct.
  • Do not assume networkidle2 means all visual content is ready. Wait for a page-specific selector or another condition that reflects when the content you need has rendered.
  • For an element capture, confirm the selector matches an element and that it is visible before taking the screenshot.

Navigation never reaches the chosen wait condition

Some pages keep network requests open or continue making requests in the background. Try a different navigation condition suited to that site, then wait explicitly for the content required in the image. No single wait option is reliable for every page.

Cloudinary rejects the upload

  • Verify the server environment variables for cloud name, API key, and API secret are present and belong to the intended Cloudinary account.
  • Check that the SDK configuration runs before the upload call and that the screenshot file exists at the path supplied to upload().
  • For stream uploads, propagate the callback error and confirm that the screenshot bytes are passed to stream.end().

The browser process remains after a failed request

Put browser shutdown in a finally block and close the browser only if launch succeeded. This covers failures during navigation, capture, or upload.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
HP EliteDesk 800 G4 Mini Tiny Business PC, Intel Hexa-Core i5-8500T up to 3.5GHz, 16GB DDR4 RAM, 256GB NVMe SSD, Dual Monitor Support, WiFi, Bluetooth, HDMI, DisplayPort, Windows 11 64-bit (Renewed)
  • Powerful Performance: Intel Core i5 Hexa Core processor for reliable multitasking and smooth computing.
  • Fast & Efficient: 16GB DDR4 RAM and 250GB SSD for quick startup and performance.
  • Windows 11 Pro: Modern operating system with professional-grade tools and enhanced security.
  • Compact Design: Space-saving mini chassis fits neatly on or under your desk.
  • Renewed Quality: Professionally tested and renewed to perform like new; may show minor cosmetic wear.

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server for developers. A single GET request can return an image or PDF; its screenshot API handles cookie banners, popups, and chat widgets before capture. Only clean shots are billed: bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, and responses include X-Page-Verdict and X-Billed headers. Its MCP server gives AI agents tools including take_screenshot, get_page_info, and capture_pdf.

For a WebP screenshot of Stripe, use cURL like this (replace the key and URL):

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webp

For a PNG, JPEG, or PDF, see the ScreenshotNeo API documentation for the relevant request options. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 screenshots. Sign up for ScreenshotNeo free.

Frequently Asked Questions

Can I upload a Puppeteer screenshot directly to Cloudinary without saving it?

Yes. Have page.screenshot() return bytes and pass a Node.js buffer to cloudinary.uploader.upload_stream(), as shown above.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Does Puppeteer capture a full page by default?

The basic page.screenshot() example captures the visible viewport. For full-page output, use Puppeteer’s fullPage screenshot option.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.