DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk6 min

How to Convert a Web Page to PDF with the CloudConvert API in Node.js

Use CloudConvert API v2 and its Node.js SDK to capture a public web page as a PDF, export the file URL, and handle job completion safely.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To convert a public web page to PDF with CloudConvert API v2 in Node.js, create a capture-website task with the page URL and output_format: "pdf", then pass that task to export/url. CloudConvert’s documented workflow returns an export URL for the resulting file. The example below uses the official Node.js SDK; keep the API key on your server and use an asynchronous job flow for production.

What the conversion workflow does

CloudConvert treats the conversion as a job made up of tasks. The first task captures a website URL as a PDF; the second exports the completed file as a downloadable URL. The operation is specifically intended for converting a website to PDF or capturing a website screenshot. CloudConvert API v2 uses the base URL https://api.cloudconvert.com/v2, and its official documentation lists a Node.js SDK.

  1. Create a CloudConvert client using an API key stored on the server.
  2. Create a job with a named capture-website task, setting url to the page and output_format to pdf.
  3. Add an export/url task whose input is the capture task’s name.
  4. Wait for completion in a simple script, or use a webhook to handle completion asynchronously in a production application.

Prerequisites and API access

  • A CloudConvert API key with the task.write scope for creating jobs.
  • Node.js and the CloudConvert Node.js SDK installed in your project.
  • A publicly reachable page URL. The documented operation accepts a URL; this example does not cover authenticated or private pages.

Keep the API key in an environment variable such as CLOUDCONVERT_API_KEY. Do not put it in browser JavaScript, a public repository, or a URL that a client can inspect. CloudConvert’s SDK import style and package details can change, so check the current SDK documentation when installing or upgrading it.

Node.js example: create a PDF job

Install the SDK using the installation instructions for the current CloudConvert Node.js package. Set CLOUDCONVERT_API_KEY in the server environment, then run this as an ES module:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
import CloudConvert from 'cloudconvert';

const apiKey = process.env.CLOUDCONVERT_API_KEY;
if (!apiKey) {
  throw new Error('Set CLOUDCONVERT_API_KEY in the server environment.');
}

const cloudConvert = new CloudConvert(apiKey);

const job = await cloudConvert.jobs.create({
  tasks: {
    'capture-page': {
      operation: 'capture-website',
      url: 'https://example.com',
      output_format: 'pdf'
    },
    'export-pdf': {
      operation: 'export/url',
      input: 'capture-page'
    }
  }
});

// Suitable for a short example; use a webhook for production completion handling.
const completedJob = await cloudConvert.jobs.wait(job.id);

const exportTask = Object.values(completedJob.tasks ?? {}).find(
  (task) => task.name === 'export-pdf'
);
const file = exportTask?.result?.files?.[0];

if (!file?.url) {
  throw new Error('The job completed without an exported file URL.');
}

console.log('PDF download URL:', file.url);

The task parameters and SDK method shape follow CloudConvert’s documented operation and quickstart examples. Confirm the installed SDK’s current import conventions and response shape against its package documentation; this instructional example has not been represented as executed or tested. The export result contains file information and a URL. Treat that URL as a download location, not as a permanent storage guarantee.

Choosing a completion and output flow

Wait for the job in a small script

jobs.wait(job.id) is convenient when you want a straightforward example that pauses until the job finishes. It ties up the caller while work completes, so it is not the best default for long-running requests or high-volume web applications.

Use webhooks for production workflows

CloudConvert recommends webhooks for job completion notifications. Create the job, return control to your application, and have a webhook handler respond when CloudConvert reports completion. Verify webhook requests according to CloudConvert’s current guidance before trusting a notification, and handle duplicate notifications safely. The Jobs reference warns that synchronous requests may be unsuitable for long-running jobs.

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

Export URL or storage integration

The export/url task makes the resulting file available through a URL. If your application needs outputs written to object storage as part of its workflow, CloudConvert also describes storage integrations. Choose the delivery mechanism based on how your application handles file access and retention rather than assuming an export URL is permanent.

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

Capture options and fidelity considerations

The capture-website operation documents optional engine selection, engine version, filename, and timeout parameters. Use those options when you have a specific rendering-engine requirement, want a predictable output name, or need to adjust the task’s time limit. Check CloudConvert’s live operation reference for accepted values and current behavior before setting them.

A URL-to-PDF operation does not by itself establish that every page will render identically to a local browser or preserve all interactive behavior. The result depends on the page and the selected engine. Validate the output for pages with dynamic content, delayed loading, or layouts that matter to your use case; do not promise fidelity beyond what the chosen engine and current service documentation support.

Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

CloudConvert’s HTML-to-PDF information describes both URL and HTML-file input. For a live web page URL, however, capture-website is the operation specifically documented for website capture.

Cost and operational notes

CloudConvert’s HTML-to-PDF page advertised a starting price of $0.008 per file when observed in 2026. This is a vendor price claim, not a guaranteed price for every job or workflow; check the current pricing page and your account’s applicable terms before estimating costs. API behavior, SDK details, and pricing can change.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  • Use asynchronous jobs and webhooks when a request may take long enough to make a waiting application request impractical.
  • Handle job failures and missing export files explicitly rather than assuming every created job produces a usable PDF.
  • Keep downloaded results in storage you control if your application needs predictable access beyond the export workflow.

Troubleshooting common problems

Authentication or permission error

Check that CLOUDCONVERT_API_KEY is present in the process environment and that the credential is valid. For job creation, the documented API scope is task.write; use a key with that permission.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

The job is created but no PDF URL appears

Inspect the job’s task statuses and the result for the named export-pdf task. The URL is produced by the export step, so confirm that its input references the capture task name exactly and that both tasks completed successfully.

The capture does not finish in time

The operation reference includes a timeout parameter. Review the current accepted parameter and limits, then adjust only when the page legitimately needs more time. For a long-running workflow, avoid relying on a synchronous wait in a request path; process completion through a webhook instead.

The PDF looks different than expected

Confirm the target URL is the intended public page and review the chosen engine and engine version. Pages with dynamic or delayed content may render differently depending on the engine and page behavior. The documented options do not establish a universal rendering guarantee, so inspect the generated file for the specific page you need to convert.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your job is to capture a page image rather than build the CloudConvert PDF workflow, ScreenshotNeo provides a one-request screenshot API. Cookie banners are accepted and 60+ known consent platforms, newsletter popups, and chat widgets are removed before capture; each of those steps can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits cost nothing, with the page verdict and billing status included in response headers. ScreenshotNeo also has an MCP server for AI agents, and supports PDF output as well as PNG, JPEG, and WebP.

For a screenshot, the cURL request is:

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

See the ScreenshotNeo API documentation for the PDF and capture options. ScreenshotNeo is made by Yorker Media. Its free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000. Sign up for the free plan.

References

  • CloudConvert Capture Website operation documentation: operation parameters and export workflow.
  • CloudConvert API quickstart: SDK and job examples.
  • CloudConvert Jobs reference: job creation scope and job behavior.
  • CloudConvert API introduction: API v2 and Node.js SDK information.
  • CloudConvert HTML-to-PDF page: URL or HTML input and vendor pricing information observed in 2026.

Frequently Asked Questions

Can I convert an HTML file instead of a live URL?

CloudConvert’s HTML-to-PDF information describes both URL and HTML-file input; use the operation documented for the input type you need.

Does the example guarantee the PDF will match Chrome pixel for pixel?

No. The operation supports engine-related options, but the documentation does not establish universal browser-fidelity guarantees.

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.

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

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

More from the Wire

  1. Shenzhen desk3 min
    HONOR Expands Beyond Smartphones With Humanoid Robot RevealHONOR said it unveiled its first humanoid robot at MWC 2026 and named shopping assistance, workplace inspections, and supportive companionship as intended uses. Later Robotics D1 claims and a reported…
  2. Cupertino desk5 min
    Apple Unveils AirPods Max 2: The Upgrade That Should Have Happened Years AgoAirPods Max 2 adds H2-powered audio features and Apple claims up to 1.5× more effective ANC, but its design, Smart Case, and 20-hour battery rating are unchanged. Wired lossless audio…
  3. Cupertino desk4 min
    Apple’s OLED Touch MacBooks Are Coming—but the Dynamic Island Is the Real GambleApple has not announced an OLED touchscreen MacBook, but reports point to high-end models arriving in late 2026 or early 2027. The reported Mac Dynamic Island could be useful, but…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.