Add Image Watermark to Image - Overlay API

PDF4me Add Image Watermark To Image is a powerful enterprise-grade solution that adds image watermarks to images through advanced API integration. This comprehensive image watermarking service efficiently processes image files, overlaying watermark images with precise positioning, custom opacity, rotation, and advanced image processing capabilities for enhanced image branding and protection. The API processes image watermarking by receiving source images and watermark images through REST API calls, utilizing advanced image processing technology and intelligent positioning algorithms for accurate watermark placement and professional image enhancement. With comprehensive support for multiple positioning options, flexible opacity control, custom rotation, precise positioning, and professional image processing, this solution is ideal for image branding, content protection, automated watermarking, and enterprise image workflows that require reliable image watermarking with guaranteed accuracy and consistent output quality. Add Image Watermark To Image documents easily with API for advanced image processing and branding.

Authenticating Your API Request

To access the PDF4me REST API, every request must include proper authentication credentials. Authentication ensures secure communication and validates your identity as an authorized user of the REST API.

Get your api Key

Key Features

• Image Watermarking: Add image watermarks to images with precise positioning and control
• Flexible Positioning: Support for multiple positioning options including diagonal, corners, and custom coordinates
• Opacity Control: Adjustable watermark transparency for subtle or prominent branding
• Rotation Support: Custom rotation angles for watermark orientation
• Professional Results: High-quality image watermarking with accurate positioning and blending
• Seamless API Integration: RESTful API designed for automated image processing workflows and enterprise system integration

REST API Endpoint

The PDF4me REST API uses standard HTTP methods to interact with resources. All image watermarking operations are performed through a single endpoint:

• Method: POST
• Endpoint: /api/v2/AddImageWatermarkToImage

Supported Image Watermarking Features

The API provides comprehensive support for various image watermarking and processing capabilities:

Watermark Positioning

• Multiple Position Options: Support for diagonal, corners, center, and custom positioning
• Precise Coordinates: Custom X and Y positioning for pixel-perfect watermark placement
• Flexible Layout: Support for various image sizes and aspect ratios
• Professional Results: High-quality watermark positioning with accurate placement
• Advanced Processing: Support for complex image layouts and watermark arrangements

Image Processing

• Opacity Control: Adjustable transparency levels for watermark visibility
• Rotation Support: Custom rotation angles for watermark orientation
• Blending Modes: Advanced image blending for natural watermark integration
• Professional Quality: High-quality image processing with accurate color handling
• Format Support: Support for various image formats and file types

Advanced Features

• Custom Positioning: Precise coordinate-based positioning for exact watermark placement
• Offset Control: Horizontal and vertical offset adjustments for fine-tuning
• Professional Enhancement: High-quality image enhancement with watermark integration
• Flexible Options: Customizable processing parameters for specific requirements

REST API Parameters

Complete list of parameters for the Add Image Watermark To Image REST API. Parameters are organized by category for better understanding and implementation.

Important: Parameters marked with an asterisk (*) are required and must be provided for the API to function correctly.

Required Parameters

Parameter	Type	Description	Example
File Name*	String	The source image filename with proper file extension for image watermarking operations. This parameter identifies the input image for watermark processing, image enhancement, and branding workflows. Required for image identification and processing pipeline management in image watermarking operations.	stamp.jpg
File Content*	Base64	The complete content of the source image encoded in Base64 format for image watermarking processing. This parameter contains the entire image data required for watermark overlay, image processing, and branding workflows. Essential for secure image handling and API-based image watermarking operations.	JVBERi...
Watermark File Name*	String	The watermark image filename with proper file extension for image watermarking operations. This parameter identifies the watermark image for overlay processing, branding, and image enhancement workflows. Required for watermark identification and processing pipeline management in image watermarking operations.	stamp.jpg
Watermark File Content*	Base64	The complete content of the watermark image encoded in Base64 format for image watermarking operations. This parameter contains the entire watermark image data required for overlay processing, branding, and image enhancement workflows. Essential for secure watermark handling and API-based image watermarking operations.	JVBERi...
Position*	String	Select the watermark positioning option for image overlay operations. Choose from topright, topleft, bottomright, bottomleft, centralhorizontal, diagonal, centralvertical, or custom. This parameter determines the watermark placement strategy and ensures proper positioning for image branding and protection workflows.	diagonal

Optional Parameters

Parameter	Type	Description	Example
Opacity	Float	Set the transparency level for the watermark overlay in image processing operations. This parameter controls the visibility and blending of the watermark with the source image. Use values between 0.0 (completely transparent) and 1.0 (completely opaque) for optimal watermark integration and professional image enhancement.	1.0
Horizontal Offset	Integer	Adjust the horizontal positioning offset for precise watermark placement in image processing operations. This parameter provides fine-tuning control for watermark positioning, enabling pixel-perfect placement and alignment. Use positive or negative values to shift the watermark horizontally for optimal branding and visual appeal.	0
Vertical Offset	Integer	Adjust the vertical positioning offset for precise watermark placement in image processing operations. This parameter provides fine-tuning control for watermark positioning, enabling pixel-perfect placement and alignment. Use positive or negative values to shift the watermark vertically for optimal branding and visual appeal.	0
Position X	Float	Specify the exact horizontal coordinate for custom watermark positioning in image processing operations. This parameter enables precise pixel-level positioning when using custom positioning mode. Use decimal values for accurate placement and professional watermark integration in image branding workflows.	0
Position Y	Float	Specify the exact vertical coordinate for custom watermark positioning in image processing operations. This parameter enables precise pixel-level positioning when using custom positioning mode. Use decimal values for accurate placement and professional watermark integration in image branding workflows.	0
Rotation	Float	Set the rotation angle for the watermark overlay in image processing operations. This parameter controls the orientation and angle of the watermark placement. Use values in degrees (0-360) for custom watermark orientation and professional image branding with rotated watermarks.	0

Output

The PDF4me Add Image Watermark To Image REST API returns a response that can be viewed in multiple formats. Choose the view that best fits your needs:

JSON

JSON Response Format

The raw JSON response from the API:

{
  "File Content": "Output file content from the PDF4me Connect"
}

Table

Table View

Response data in a structured table format:

Parameter	Value
File Content	Output file content from the PDF4me Connect

Schema

Schema View

The data structure and types of the response:

1 item
File Content: Binary Output file content from the PDF4me Connect

Type Indicators:

• Binary = Binary data

Binary

Binary Data View

The actual watermarked image file data:

data
─────────────────────────────
File Content: Output file content from the PDF4me Connect

Binary Data Access:

• Image Content: Ready for download or further processing
• Watermarked Image: Complete image with watermark overlay

Request Example

Header

Content-Type: application/json
Authorization:  YOUR_API_KEY

Note: Get your API key from the PDF4me Dashboard

Payload

{
  "docName": "stamp.jpg",
  "docContent": "Please put image base64 content",
  "WatermarkFileName": "stamp.jpg",
  "WatermarkFileContent": "Please put image base64 content",
  "Position": "diagonal",
  "Opacity": 1.0,
  "PositionX": 0,
  "PositionY": 0,
  "Rotation": 0
}

Code Samples

The PDF4me Add Image Watermark To Image REST API provides code samples in multiple programming languages. Choose the language that best fits your development environment:

C#

C# (CSharp) Sample

Complete C# implementation for adding image watermarks to images:

View C# Sample

Java

Java Sample

Java implementation with full error handling and response processing:

View Java Sample

JavaScript

JavaScript Sample

Node.js and browser-compatible JavaScript implementation:

View JavaScript Sample

Python

Python Sample

Python implementation with requests library and JSON handling:

View Python Sample

Salesforce

Salesforce Sample

Salesforce Apex implementation for CRM integration:

View Salesforce Sample

n8n

n8n Sample

n8n workflow implementation for automation:

View n8n Sample

Google Script

Google Script Sample

Google Apps Script implementation for Google Workspace integration:

View Google Script Sample

AWS Lambda

AWS Lambda Sample

Serverless AWS Lambda function implementation:

View AWS Lambda Sample

Image Watermarking Features

Watermark Positioning

• Multiple Position Options: Support for diagonal, corners, center, and custom positioning
• Precise Coordinates: Custom X and Y positioning for pixel-perfect watermark placement
• Flexible Layout: Support for various image sizes and aspect ratios
• Professional Results: High-quality watermark positioning with accurate placement
• Advanced Processing: Support for complex image layouts and watermark arrangements

Image Processing

• Opacity Control: Adjustable transparency levels for watermark visibility
• Rotation Support: Custom rotation angles for watermark orientation
• Blending Modes: Advanced image blending for natural watermark integration
• Professional Quality: High-quality image processing with accurate color handling
• Format Support: Support for various image formats and file types

Advanced Features

• Custom Positioning: Precise coordinate-based positioning for exact watermark placement
• Offset Control: Horizontal and vertical offset adjustments for fine-tuning
• Professional Enhancement: High-quality image enhancement with watermark integration
• Flexible Options: Customizable processing parameters for specific requirements

Industry Use Cases & Applications

Use Cases

Use Cases

• Image Branding: Add company logos and branding elements to images for brand protection
• Content Protection: Watermark images to prevent unauthorized use and protect intellectual property
• Photography: Add photographer watermarks to protect professional photography work
• Social Media: Brand images for social media marketing and content creation
• E-commerce: Watermark product images for online stores and marketplaces
• Documentation: Add watermarks to technical documentation and diagrams
• Marketing: Brand marketing materials and promotional images
• Business Process Automation: Automate image watermarking workflows for enterprise operations

Get Help

Get Your API KeyAPI SamplesGetting Started