ConvertApi Logo

PNG to WATERMARK API

Add text watermark to PNG image easily with Watermark PNG API.

API Request:
Copy parameter's URL Secret Secret
Optional

String Authentication secret must be provided as a query parameter. If omitted, token must be provided.

Show all
Copy parameter's URL Token Token
Optional

String Authentication token must be provided as a query parameter. If omitted, secret must be provided.

Show all
Copy parameter's URL File File
Required

File File to be converted. Value can be URL or file content.

Show all
Copy parameter's URL StoreFile Store file
Optional

Bool Store converted file on our secure server and provides download URL.

Default: False

Show all
Copy parameter's URL FileName File name
Optional

String Converted output file name without extension. The extension will be added automatically.

Show all
Copy parameter's URL Timeout Timeout
Optional

Integer Conversion timeout in seconds.

Default: 900

Range: 10 .. 1200

Show all
Copy parameter's URL Async Asynchronous
Optional

Bool Run conversion job asynchronously.

Default: False

Show all
Copy parameter's URL JobId Job ID
Optional

String Conversion job self generated UUID (RFC 4122) used for getting conversion result asynchronously. Also automatically added to WebHook url.

Show all
Copy parameter's URL WebHook WebHook
Optional

String Set WebHook URL to call after conversion is finished. Also works for synchronous requests.

Show all
Copy parameter's URL Text Watermark text
Required

String Specifies the text to use as watermark. The list of supported variables:

%PAGE% - current page number,
%PAGES% - total number of pages,
%FILENAME% - name of the file,
%WEEKDAY% - full weekday name,
%WEEKDAY_SHORT% - abbreviated weekday name,
%MONTH% - month number (1-12),
%MONTHNAME% - full month name,
%MONTHNAME_SHORT% - abbreviated month name,
%YEAR% - year with century (YYYY),
%YEAR_SHORT% - year without century (YY),
%DAY% - day of month,
%DAY_YEAR% - day of the year (1 -366),
%HOUR% - hour (01- 12),
%HOURS% - hour (00-23),
%MINUTES% - minutes (00-59),
%SECONDS% - seconds (00-59),
%AMPM% - AM PM,
%DATE% - local date representation,
%TIME% - local time representation,
%DATETIME% - local date and time,
%AUTHOR% - document Author,
%TITLE% - document Title,
%SUBJECT% - document Subject,
%KEYWORDS% - document Keywords.

Show all
Copy parameter's URL FontName Watermark font name
Optional

Collection Specifies the watermark font name. Contact us if you are looking for a specific font for a watermark that is missing from the list.

Default: Arial

Values: Arial, Bahnschrift, Calibri, Cambria, Consolas, Constantia, Courier New, Georgia, Tahoma, Times New Roman, Verdana

Show all
Copy parameter's URL FontSize Watermark font size
Optional

Integer Specifies the watermark font size.

Default: 40

Range: 1 .. 200

Show all
Copy parameter's URL FontColor Watermark font color
Optional

String Specifies the watermark font color.

Default: #ffffff

Show all
Copy parameter's URL StrokeColor Stroke color
Optional

String Specifies font stroke color.

Default: #271851

Show all
Copy parameter's URL StrokeWidth Stroke width
Optional

Integer Specifies the stroke width.

Default: 1

Range: 0 .. 200

Show all
Copy parameter's URL FontEmbed Embed watermark font
Optional

Bool Specifies whether fonts should be embedded.

Default: True

Show all
Copy parameter's URL FontSubset Font subset
Optional

Bool Specifies whether fonts should be subset.

Default: True

Show all
Copy parameter's URL FontEncoding Font encoding
Optional

String Specifies the font encoding.

Show all
Copy parameter's URL TextRenderingMode Text rendering mode
Optional

Collection Specifies the text rendering mode.

Default: fillstroke

Values: filltext, stroketext, fillstroke, invisible

Show all
Copy parameter's URL Rotate Rotate watermark
Optional

Integer Specifies the watermark rotation angle in degrees.

Default: 0

Range: 0 .. 360

Show all
Copy parameter's URL HorizontalAlignment Horizontal watermark alignment
Optional

Collection Specifies the horizontal watermark alignment.

Default: center

Values: left, center, right

Show all
Copy parameter's URL VerticalAlignment Vertical watermark alignment
Optional

Collection Specifies the vertical watermark alignment.

Default: center

Values: top, center, bottom

Show all
Copy parameter's URL PositionX Watermark X coordinate
Optional

Integer Specifies the watermark X coordinate. If set overrides property HorizontalAlignment.

Range: 1 .. 10000

Show all
Copy parameter's URL PositionY Watermark Y coordinate
Optional

Integer Specifies the watermark Y coordinate. If set overrides property VerticalAlignment.

Range: 1 .. 10000

Show all
Copy parameter's URL PositionUnit Watermark position unit
Optional

Collection Specifies measurement unit to use for the PositionX and PositionY properties.

Default: pt

Values: pt, in, mm, cm

Show all
Copy parameter's URL Opacity Opacity level
Optional

Integer Specifies watermark opacity level.

Default: 100

Range: 0 .. 100

Show all

Show parameters

Snippets are autogenerated according to converter parameter choices above. Please select file in "File" or "Files" parameter before using code snippets.

Code snippet is using ConvertAPI JavaScript Client

Code snippet is using ConvertAPI Node.js Client

Code snippet is using ConvertAPI PHP Client

Code snippet is using ConvertAPI Java Client

Code snippet is using ConvertAPI C# Client

Code snippet is using ConvertAPI Ruby Client

Code snippet is using ConvertAPI Python Client

Code snippet is using ConvertAPI Go Client

Code snippet is using command line utility program

For conversions with the multiple file result please refer to the example