---
title: Apply Watermark on Images API
slug: apply-watermark
url: https://apyverse.com/apyhub/service/apply-watermark
provider: ApyHub
categories: [File Manipulation, Image Processing]
auth: api_key
---

# Apply Watermark on Images API

Add text or image watermarks from upload, URL, or Base64 input. Return a processed image file or a signed download link.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/processor/image/watermark/file` | What it does Applies a watermark to an uploaded image and returns the processed file as binary outp… | 60 |
| POST | `/processor/image/watermark/file/url` | What it does Applies a watermark to an uploaded image and returns a URI for the resulting file. The… | 60 |
| POST | `/processor/image/watermark/url/file` | What it does Applies a watermark to an image fetched from a URL and returns the resulting file as b… | 60 |
| POST | `/processor/image/watermark/file-urls` | What it does Applies a watermark to an image fetched from a signed URL. The request body supplies t… | 60 |
| POST | `/processor/image/watermark/base64/file` | What it does Applies a watermark to a source image provided as Base64 and returns the processed fil… | 60 |
| POST | `/processor/image/watermark/base64/url` | What it does Applies a watermark to a source image provided as Base64 and returns a JSON object con… | 60 |

## About

## What it does
Watermark Images adds text or image watermarks to an input image and returns the processed file or a signed download link. Use it when you need to brand marketing assets, stamp drafts, or protect shared visuals before sending them downstream.

Send an image as multipart upload, by URL, or as Base64. Across those input modes, you can choose either a text watermark or an image watermark, then control placement and styling with fields such as `watermark_position`, `watermark_opacity`, `watermark_angle`, `watermark_font_size`, `watermark_font_color`, `watermark_image_size`, `watermark_text_padding`, `watermark_text_alignment`, `watermark_text_line_spacing`, and `watermark_text_background_color`.

The multipart and Base64 endpoints accept `size` plus the source image and watermark payload. The URL-based endpoints fetch the source image from `image_url` and let you reference the watermark with `watermark_image_url` or set `watermark_text` directly. For Base64 requests, `image_base64` is required and the watermark can be passed as `watermark_base64`.

Use `.../download` when you want the watermarked image bytes back immediately, or `.../link` when your workflow needs a `data` URI in the response. `preserve_format` is available on the file-based endpoints when you need to keep the original output format.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/apyhub/service/apply-watermark