How to Add a Watermark to a Video using an API?

Watermarking is the process of placing an image, text, or logo on top of a video. There are several reasons to use this technique, including making videos according to a brand style, adding titles and overlaying visual elements over existing videos. To watermark videos using an API, send the following API request:

API Request
curl -s -X POST \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-binary @- << EOF
  "source": {
    "output_format": "mp4",
    "elements": [
        "type": "video",
        "source": ""
        "type": "image",
        "source": "",
        "x": "100%",
        "y": "0%",
        "width": "60 vmin",
        "height": "60 vmin",
        "x_padding": "7 vmin",
        "y_padding": "7 vmin",
        "x_anchor": "100%",
        "y_anchor": "0%",
        "x_alignment": "100%",
        "y_alignment": "0%",
        "shadow_color": "rgba(0,0,0,0.66)",
        "fit": "contain"
Output Video

How it works: This example uses cURL to invoke the Creatomate video editing API. The REST API works by defining a video composition in JSON format. The API will then perform the operation in the cloud and return the watermarked video.

In this example, the video composition is comprised of two elements: a background video and a logo that appears above the background video. You can host the input files at any publicly accessible URL.

The watermark image, in this example a logo, is located in the top-right corner of the video. To accomplish this, we need to specify the "x" and "y" properties along with the "x_anchor" and "y_anchor" properties. And using the "padding" property, we can give some space between the logo and video edges.

As you can see, all properties are defined in terms of relative units, like "vmin" and "%". As a result, the watermark adjusts dynamically based on the background video's format, which allows it to be responsive and compatible with any resolution, such as horizontal, vertical, or square video.

This is just one example of how to use Creatomate's video API. If you want to create more advanced video compositions, you can use the video editor. This online tool allows you to create your own templates that can then be exported as JSON to be used in your API automation workflows.

Edit this Code Example in the Video Editor

Easily design your own video templates using the online editor. Then, export your templates as JSON and integrate them into your application to create any kind of video – completely through code.

Related API Video Editing Questions

Start automating today

Start with a full-featured trial with 50 credits – no credit card required.