Image to PDF Converter

Convert images from URLs into a professionally formatted PDF document. Supports batch processing, multiple page sizes, orientations, fit modes, and image quality settings. Ideal for archiving, reporting, and document generation workflows.

Overview

This actor downloads images from provided URLs, processes them with sharp for optimal quality and compression, and assembles them into a single PDF using pdf-lib. Each image gets its own page, sized and positioned according to your configuration. Failed images are gracefully skipped with error reporting, so a single broken link never blocks the entire batch.

Features

• Batch processing — Convert hundreds of images in a single run with parallel downloads
• Multiple page sizes — A3, A4, A5, Letter, Legal, or Auto (sizes pages to match images)
• Flexible orientation — Portrait, landscape, or auto-detect based on image aspect ratio
• Four fit modes — Fit (maintain ratio), fill (cover page), stretch, or original size
• Configurable quality — JPEG compression from 1-100 for size vs quality tradeoff
• PNG transparency — Transparent PNGs are preserved as-is; opaque images convert to JPEG
• Page numbers — Optional centered page numbers at the bottom of each page
• PDF metadata — Set title and author in document properties
• Retry logic — Failed downloads retry up to 3 times with exponential backoff

Input Example

{
  "images": [
    { "url": "https://example.com/photo1.jpg", "label": "Cover" },
    { "url": "https://example.com/chart.png", "label": "Q4 Results" },
    { "url": "https://example.com/diagram.png" }
  ],
  "pageSize": "A4",
  "orientation": "auto",
  "fitMode": "fit",
  "imageQuality": 85,
  "addPageNumbers": true,
  "title": "Quarterly Report",
  "outputFileName": "report.pdf"
}

Output

The actor saves the generated PDF to the default key-value store and pushes metadata to the dataset:

{
  "fileName": "report.pdf",
  "pageCount": 3,
  "fileSizeBytes": 524288,
  "kvStoreKey": "report.pdf",
  "images": [
    { "url": "https://example.com/photo1.jpg", "originalSize": { "width": 1920, "height": 1080 }, "pageNumber": 1, "status": "success" },
    { "url": "https://example.com/chart.png", "originalSize": { "width": 800, "height": 600 }, "pageNumber": 2, "status": "success" },
    { "url": "https://example.com/diagram.png", "originalSize": { "width": 1200, "height": 900 }, "pageNumber": 3, "status": "success" }
  ],
  "processingTimeMs": 2100
}

Use Cases

• Report generation — Combine charts, screenshots, and photos into a single downloadable PDF
• Image archival — Batch-convert image collections into organized PDF documents
• Invoice/receipt compilation — Merge scanned images into one document for accounting
• Portfolio creation — Assemble design work or photography into a presentation-ready PDF
• Monitoring dashboards — Capture and compile dashboard screenshots on a schedule

Pricing

This actor uses pay-per-event pricing. You are charged per image successfully converted and embedded in the PDF. Failed images are not charged.

Event	Price
Image converted	$3.00 per 1,000 images

Integrations

Combine this actor with other tools in your workflow:

• Use a web scraper to extract image URLs, then pipe them into this actor
• Schedule regular runs to compile daily screenshots into PDF reports
• Chain with email or cloud storage actors to deliver PDFs automatically

FAQ

What image formats are supported?

Any format supported by sharp: JPEG, PNG, WebP, AVIF, TIFF, GIF (first frame), and SVG. Images are automatically converted to JPEG for optimal PDF size, except transparent PNGs which are preserved.

What happens if an image URL is broken?

The actor retries each download up to 3 times. If all attempts fail, that image is skipped and reported with status "failed" in the output. The PDF is still generated with all successful images.

How large can the output PDF be?

The actor runs with 2 GB of memory by default. For very large batches (500+ high-resolution images), consider increasing the memory allocation in run options.