Add Watermark Text on Image

POSThttps://picnie.com/api/v1/add-watermark-text-on-image

Add text watermark to an image specified by its URL, with customizable font, position, and styling.

Headers

Name	Type	Description
Authorization*	string	Pass api key in the authorization field Example:`YOUR_API_KEY`

Body Parameters

Name	Type	Description
project_id*	string	The ID of the project. Example:`1867`
image_url*	string	URL of the image to add text watermark to. Example:`https://picnie.com/assets/demo_phone.jpg`
watermark_text*	string	Text to use as the watermark. Example:`© 2025 Picnie`
position*	string	Position of the watermark. Values: top-left, top-center, top-right, middle-left, middle-center, middle-right, bottom-left, bottom-center, bottom-right. Example:`bottom-right`
font_size*	integer	Font size of the watermark text in pixels. Example:`32`
font_path*	string	Path to the font file (e.g., Anton-Regular.ttf). Example:`Anton-Regular.ttf`
font_color*	string	Color of the watermark text in hexadecimal (e.g., #FF0000 for red). Example:`#FF0000`
opacity*	float	Opacity of the watermark text (0.0 to 1.0). Example:`0.8`
rotation*	integer	Rotation angle of the watermark text in degrees. Example:`45`
padding*	integer	Padding around the watermark text in pixels. Example:`20`
background_color*	string	Background color of the watermark text in hexadecimal (e.g., #000000 for black). Example:`#000000`
background_opacity*	float	Opacity of the watermark text background (0.0 to 1.0). Example:`0.5`

Notes

⚠️ Authentication required

curl -X POST "https://picnie.com/api/v1/add-watermark-text-on-image"
-H "Authorization: YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
    "image_url": "https://picnie.com/assets/demo_phone.jpg",
    "project_id": "1867",
    "watermark_text": "© 2025 Picnie",
    "position": "bottom-right",
    "font_size": 32,
    "font_path": "Anton-Regular.ttf",
    "font_color": "#FF0000",
    "opacity": 0.8,
    "rotation": 45,
    "padding": 20,
    "background_color": "#000000",
    "background_opacity": 0.5
}'

Responses

200200 OK

{
    "error": false,
    "message": "Success",
    "url": "https://picnie.s3.ap-south-1.amazonaws.com/user_10/project_1867/wmt_5396_250628115604.jpg"
}