🎨

Image Watermark

Overlay a logo or watermark image onto a base image

GET 10 credits /v1/image/watermark/image

curl "https://image.toolkitapi.io/v1/image/watermark/image?base_url=https://toolkitapi.io/static/samples/sample-image.png&watermark_url=https://toolkitapi.io/static/samples/sample-watermark.png&position=bottom-right&scale=0.15&opacity=0.6"

import httpx

resp = httpx.get(
    "https://image.toolkitapi.io/v1/image/watermark/image?base_url=https://toolkitapi.io/static/samples/sample-image.png&watermark_url=https://toolkitapi.io/static/samples/sample-watermark.png&position=bottom-right&scale=0.15&opacity=0.6",
)
print(resp.json())

const resp = await fetch("https://image.toolkitapi.io/v1/image/watermark/image?base_url=https://toolkitapi.io/static/samples/sample-image.png&watermark_url=https://toolkitapi.io/static/samples/sample-watermark.png&position=bottom-right&scale=0.15&opacity=0.6", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "image": "/9j/4AAQSkZJRgABAQ...(base64 data)...",
  "format": "png",
  "position": "bottom-right",
  "watermark_size": {"width": 288, "height": 72}
}

Try It Live

Live Demo

Response

Description

Overlay a logo or watermark image onto a base image

How to Use

1

1. Provide the base image via `base_url` and the watermark via `watermark_url` query parameters.

2

2. Set `scale` (0.01–1.0) to control watermark size as a fraction of the base image width.

3

3. Choose a `position` preset and adjust `opacity` (0.0–1.0) for visibility.

4

4. The response includes the composited image and the computed watermark dimensions.

About This Tool

Use the Image Watermark endpoint to overlay a logo, badge, or any image onto a base image. The watermark is automatically scaled relative to the base image width and positioned using gravity presets.

This is perfect for branding automation — stamp your logo on every product photo, social media image, or portfolio piece. Opacity control ensures the watermark is visible without being distracting.

Why Use This Tool

Brand watermarking — Automatically stamp your logo on all product images
Photography portfolios — Add a signature watermark to portfolio previews
Document marking — Overlay confidentiality badges on sensitive documents
Social media — Add your channel logo to content before posting
E-commerce — Brand product photos at scale

Frequently Asked Questions

Does the watermark maintain its aspect ratio?

Yes. The watermark is scaled by width (based on the `scale` fraction of the base image width), and the height is calculated proportionally to maintain the original aspect ratio.

Should my watermark have a transparent background?

Yes, PNG watermarks with transparent backgrounds produce the best results. Opaque watermarks will show their background colour.

Can I place the watermark at exact pixel coordinates?

The current endpoint uses gravity presets (top-left, top-right, bottom-left, bottom-right, center) with a 20px margin. For pixel-precise placement, use the Composite endpoint instead.

Start using Image Watermark now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs