Back to Blog

How to Programmatically Add Watermarks to Videos Using FFMPEGAPI.net

June 2026 FFMPEG API Team

In the world of video editing and processing, adding a watermark is an important step for branding and copyright protection. With FFMPEGAPI.net, developers can programmatically add watermarks to videos without dealing with complex server setups or FFmpeg infrastructure management. This article will explore how to use FFMPEGAPI.net's hosted API to overlay a watermark image onto your videos seamlessly.

Why Use FFMPEGAPI.net for Video Watermarking?

FFMPEGAPI.net provides a simple and efficient way to integrate video processing capabilities into your applications. With its API-key authentication, developers can easily authenticate their requests, making it ideal for automation, SaaS applications, content pipelines, and AI agents.

Using FFMPEGAPI.net eliminates the need for server setup, allowing you to focus on building features rather than managing infrastructure.

  • No server setup required.
  • Easy API-key authentication.
  • Background processing with async support.
  • Scalable solution for content pipelines.

Endpoint Overview: Add Watermark

The endpoint for adding a watermark to a video is a POST request to `/api/add_watermark`. This endpoint allows you to overlay a watermark image on your video while providing options for placement and scaling.

The key parameters for this API call include the video URL, watermark URL, position of the watermark, and scale factor.

  • Endpoint: `/api/add_watermark`
  • Method: POST
  • Content Type: application/json

Parameters for Adding a Watermark

Here’s a breakdown of the parameters you can use when calling the `/api/add_watermark` endpoint:

- `video_url`: The URL of the video you want to watermark (required).

- `watermark_url`: The URL of the watermark image (required).

- `position`: The position of the watermark on the video; options include top-left, top-center, top-right, middle-left, middle, middle-right, bottom-left, bottom-center, bottom-right (default is bottom-right).

- `scale`: A number representing the width of the watermark as a fraction of the video width, ranging from 0.05 to 1.0 (default is 0.25).

Practical Example: Adding a Watermark

To illustrate how to add a watermark, here’s an example API call using curl:

In this example, we will watermark a video located at `https://example.com/video.mp4` using a logo at `https://example.com/logo.png`, placing it in the bottom-right corner at a scale of 0.2.

curl -X POST https://ffmpegapi.net/api/add_watermark \
     -H 'Content-Type: application/json' \
     -d '{ \
         "video_url": "https://example.com/video.mp4", \
         "watermark_url": "https://example.com/logo.png", \
         "position": "bottom-right", \
         "scale": 0.2 \
     }'

FFMPEGAPI.net is the best choice for developers looking to programmatically add watermarks to videos. With its easy-to-use hosted REST API, you can focus on building your application while leaving the video processing to FFMPEGAPI.net. Start integrating this powerful tool into your projects today and see how it can enhance your video processing workflows.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free