API Basics
Fundamentals
Multicloud / Geofence
API Examples
API Specification
SDKs / Codegen
Batch Processing
Best Practice
Error Codes
Data Tools
Email Validate
Phone Validate
UA Lookup
Bad Word Filter
Convert
WWW
Browser Bot
HTML Clean
URL Info
Telephony
Phone Verify
SMS Verify
Verify Security Code
Phone Playback
HLR Lookup
Rates
Geolocation
IP Info
Geocode Address
Geocode Reverse
Security and Networking
Domain Lookup
Email Verify
IP Probe
IP Blocklist
IP Blocklist Download
Host Reputation
E-commerce
BIN Lookup
BIN List Download
Currency Convert
Imaging
HTML Render
Image Resize
★  Image Watermark
QR Code
Legacy APIs
User Agent Info
HTML5 Render
SMS Message
HTML Extract
Code Highlight

Image Watermark

Watermark one image with another image.

This API works by taking the source image and overlaying this image with another image (the watermark) at the specified location using alpha blending. You can also convert many image formats automatically, we currently support source images in these formats: GIF, ICO, JPEG, PNG, TIFF.

End Point

https://neutrinoapi.net/image-watermark
Test API
API Request
ParameterRequiredTypeDefaultDescription
image-urlyesstringThe URL or Base64 encoded Data URL for the source image. You can also upload an image file directly using multipart/form-data
watermark-urlyesstringThe URL or Base64 encoded Data URL for the watermark image. You can also upload an image file directly using multipart/form-data
opacitynointeger50The opacity of the watermark (0 to 100)
formatnostringpngThe output image format, can be either png or jpg
positionnostringcenterThe position of the watermark image, possible values are:
center, top-left, top-center, top-right, bottom-left, bottom-center, bottom-right
widthnointegerIf set resize the resulting image to this width (in px)
heightnointegerIf set resize the resulting image to this height (in px)
resize-modenostringscaleThe resize mode to use, we support 3 main resizing modes:
  • scale
    Resize to within the width and height specified while preserving aspect ratio. In this mode the width or height will be automatically adjusted to fit the aspect ratio
  • pad
    Resize to exactly the width and height specified while preserving aspect ratio and pad any space left over. Any padded space will be filled in with the 'bg-color' value
  • crop
    Resize to exactly the width and height specified while preserving aspect ratio and crop any space which fall outside the area. The cropping window is centered on the original image
bg-colornostringtransparentThe image background color in hexadecimal notation (e.g. #0000ff). For PNG output the special value of 'transparent' can also be used. For JPG output the default is black (#000000)
API Response
API Performance
CharacteristicValueDescription
Avg Latency80msAverage RTT for requests within the same data center/region
Max Rate6/secondMaximum inbound request rate. Exceeding this will result in request throttling
Max Concurrency50Maximum concurrent/simultaneous requests. Exceeding this will result in error code 06 [TOO MANY CONNECTIONS]

API Example
curl https://neutrinoapi.net/image-watermark \ --header "User-ID: <your-user-id>" \ --header "API-Key: <your-api-key>" \ --data-urlencode "resize-mode=scale" \ --data-urlencode "format=png" \ --data-urlencode "width=" \ --data-urlencode "image-url=https://www.neutrinoapi.com/img/LOGO.png" \ --data-urlencode "position=center" \ --data-urlencode "watermark-url=https://www.neutrinoapi.com/img/icons/security.png" \ --data-urlencode "opacity=50" \ --data-urlencode "bg-color=transparent" \ --data-urlencode "height=" \ --output "image-watermark.png"