API Basics
Data Tools
WWW
Browser Bot
HTML Clean
URL Info
Telephony
Geolocation
Security and Networking
E-commerce
Imaging
Legacy APIs

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"