Discover available presets

For some conversion targets we offer the option to select a public preset from us. This preset will internally set some conversion options to meet a special target device or platform. To find out which presets are available, we provide the following endpoint: https://api.api2convert.com/v2/presets

Here, you can also set some parameters to find a specific preset. You can use category, target and filter. Filter will search the preset name and can be a comma separated list of search terms.

E.g. https://api.api2convert.com/v2/presets?category=video&target=mp4&filter=facebook,hq

The information you get looks similar to this:

[
    {
        id: "2c450e57-ef64-469d-8245-c39535994de2",
        name: "Facebook HQ 1280x720 (HD) 23.976fps",
        category: "video",
        target: "mp4",
        scope: "public"
    },
    {
        id: "5ad9f696-7930-4991-9f03-460c3d703b89",
        name: "Facebook HQ 1280x720 (HD) 25fps",
        category: "video",
        target: "mp4",
        scope: "public"
    },
    ...
]

The result can also include your custom presets. To find out how to save your own preset have a look here.

The value you have to set for the option preset is the id. So, if you want to use the "Facebook HQ 1280x720 (HD) 25fps" preset, you set the option "preset": "5ad9f696-7930-4991-9f03-460c3d703b89".

If you combine a preset with other options of your choice, we always overwrite the preset options with the manually set options.

Now we can proceed to create a job with the options that we need.