Back to Blog

How to Programmatically Add Watermarks to Videos Using FFMPEGAPI.net

July 2026 FFMPEG API Team

Watermarking videos is a crucial task for many content creators and developers. With FFMPEGAPI.net, you can add watermarks to your videos programmatically without the hassle of managing servers or complex FFmpeg setups. In this article, we'll explore how to use our hosted API to overlay a watermark image onto your videos with ease.

Understanding the Add Watermark API Endpoint

The Add Watermark endpoint allows developers to overlay a watermark image onto a video. This is particularly useful for brand reinforcement, copyright claims, and enhancing visual identity.

The simplicity of using a hosted REST API means you can focus on your development workflow without worrying about server management or FFmpeg infrastructure.

  • No server setup required.
  • API-key authentication to secure your requests.
  • Configurable watermark placement and scaling.

API Endpoint Details

To use the Add Watermark feature, you will interact with the following API endpoint:

POST /api/add_watermark

This endpoint requires a few parameters to function effectively. Below is a breakdown of the parameters you need to provide.

  • video_url (string, required): The URL of the video you want to watermark.
  • watermark_url (string, required): The URL of the watermark image.
  • position (string, optional): The placement of the watermark on the video. Default is 'bottom-right'.
  • scale (number, optional): The scale of the watermark as a fraction of the video width, from 0.05 to 1.0. Default is 0.25.
  • async (boolean, optional): If true, returns a job_id immediately and processes the request in the background.

Practical Example of Adding a Watermark

Here's how you can use curl to make a request to the Add Watermark endpoint. This example demonstrates adding a watermark to a video hosted online.

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

FFMPEGAPI.net offers a powerful yet straightforward solution for developers looking to incorporate video processing capabilities into their applications. By using our hosted API, you can easily add watermarks to your videos without the burden of server management. Join us today and simplify your video editing workflow with FFMPEGAPI.net.

Ready to Start Processing Videos?

Get your free API key and start merging videos in minutes

Get Started Free