Add Text Watermark to Image
Image → Add Text Watermark to Image
The Add Text Watermark to Image API overlays text on an image. You send the image as Base64 (docContent), docName, WatermarkText, TextPosition (e.g. bottomleft, centralhorizontal), and optionally font, color, opacity, and async. The API returns the image with the text watermark. Use the tester below to try it; more details are in the sections that follow.
Try the Add Text Watermark to Image API
Endpoint: POST /api/v2/AddTextWatermarkToImage · Required: api-key, docContent, docName, WatermarkText, TextPosition
Use the form below to send your API key, image (Base64), watermark text, and position. Adjust font, color, and opacity as needed; the response is the watermarked image. No code required—fill the fields and click Send request.
Overview, parameters, and use cases
- Overview
- Parameters
- Use cases
What is Add Text Watermark to Image?
This endpoint adds a text watermark to an image. You provide the image (Base64), docName, WatermarkText, and TextPosition (e.g. topright, bottomleft, centralhorizontal, diagonal, custom). Optional settings include TextFontFamily, TextFontSize, TextColour, IsBold, IsItalic, IsUnderline, Opacity, RotationAngle, and custom PositionX/PositionY when TextPosition is custom. The API returns the image with the watermark applied.
Key features
- Text position – topright, topleft, bottomright, bottomleft, centralhorizontal, centralvertical, diagonal, or custom (with PositionX, PositionY).
- Font and style – Font family, size, color, bold, italic, underline.
- Opacity and rotation – Control visibility and angle of the text.
Use when you need to brand or label images with text. For image overlays use Add Image Watermark to Image.
API parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api-key | string | Yes | Your PDF4me API key, Base64 encoded. Get it from the dashboard. |
| docContent | base64 | Yes | Image file content (Base64). Supported: JPG, PNG, GIF, BMP, TIFF. |
| docName | string | Yes | Output image file name. |
| WatermarkText | string | Yes | Text to use as the watermark. |
| TextPosition | string | Yes | Position: topright, topleft, bottomright, bottomleft, centralhorizontal, centralvertical, diagonal, custom. |
| TextFontFamily, TextFontSize, TextColour | string/integer | No | Font and color for the watermark. |
| IsBold, IsUnderline, IsItalic | boolean | No | Text style. |
| Opacity, RotationAngle, PositionX, PositionY | number | No | Opacity, rotation, and custom position. |
| async | boolean | No | Enable asynchronous processing. |
When to use Add Text Watermark to Image
- Branding – Add logos, copyright, or “Draft” text to images.
- Labels – Overlay captions or labels on photos or screenshots.
- Protection – Add visible text to discourage unauthorized use.
For request/response schemas and code samples, see Add Text Watermark to Image in the PDF4me API docs.
Prerequisites
Before using this endpoint, make sure you have:
- A valid PDF4me API key (Get your API Key)
- An image file (JPG, PNG, GIF, BMP, TIFF) in Base64 format
Response Format
The API returns an image file with the text watermark applied.