CloudConvertdocs
Operations

Optimize Files

Compress and optimize PDF, PNG and JPG files.

To optimize a file, create a job with a optimize task.

The available parameters differ based on input_format. Select a value below to show all available conversion options.

Task Parameters

operation
string required
Value is optimize.
input
string or array of task names required

The input task name(s) for this task.

input_format
string

The current format of the file, e.g. pdf. If not set, the extension of the input file is used as input format.

engine
string

Use a specific engine for the conversion.

engine_version
string

Use a specific engine version for the conversion.

filename
string

Choose a filename (including extension) for the output file.

timeout
integer

Timeout in seconds after the task will be cancelled. By default, tasks time out after 5 hours.

Example Job

Using the parameters from above, you can create a job:

POSThttps://api.cloudconvert.com/v2/jobs
Use the Job Builder to generate and try out optimize jobs.

PDF Optimization Profiles

When compressing PDFs, the following profiles are available:

web Optimization for the web (Default profile)

  • Remove redundant and unnecessary data for the web
  • Down-sample, clip, and intelligently compress images
  • Merge and subset fonts
  • Convert colors to RGB

print Optimization for print

  • Remove redundant and unnecessary data for printing
  • Down-sample, clip, and intelligently compress images
  • Merge and subset fonts
  • Convert colors to CMYK

archive Optimization for archiving purposes

  • Remove redundant and unnecessary data for archiving
  • Intelligently compress images
  • Merge and subset fonts

mrc Optimization for scanned images

  • Profile optimized for PDFs that mainly consist of raster images
  • Compress the images without significantly reducing the visual quality

max Optimization for maximal size reduction

  • Use the maximal possible compression
  • Might reduce the visual quality

Convert Files

Convert files to different formats.

Add Watermarks

Add a watermark to a PDF file, to an image (PNG, JPG...) or to a video (MP4, MOV...).