Overlay semi-transparent watermark text.

Overlay semi-transparent watermark text. Drop this helper wherever you want to overlay semi-transparent watermark text with a single HTTP call. Send the documented inputs and the API streams back polished results you can hand directly to your users.

GETPOST/media/add-watermark

Visual example

Sample request

POST https://api.dataczar.com/media/add-watermark {"url":"https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&w=960&q=80","text":"dataczar","position":"se"}

Where this helper shines

Overlay semi-transparent watermark text. keeps media helpers on autopilot. Use it whenever you need to overlay semi-transparent watermark text without pausing a sprint or asking design/dev to jump in.

Trigger this helper whenever you need to overlay semi-transparent watermark text without waiting on a full deploy.
Drop it into automations (Zapier, Make, workers) to overlay semi-transparent watermark text as part of your workflow.
Share the GET URL so support and success can overlay semi-transparent watermark text safely using their Dataczar API key.

Copy & ship snippets

GET

Instant link

GET https://api.dataczar.app/media/add-watermark?url=https%3A%2F%2Fexample.com%2Fsample.png&text=Launch+promo&position=bottom-right&opacity=0.4&ak=demo

Open directly in any browser, webhook, or low-code workflow.

curl

curl GET

curl "https://api.dataczar.app/media/add-watermark?url=https%3A%2F%2Fexample.com%2Fsample.png&text=Launch+promo&position=bottom-right&opacity=0.4&ak=demo"

Swap ak=demo with your Dataczar API key.

curl

curl POST

curl -X POST "https://api.dataczar.app/media/add-watermark?ak=demo" \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/sample.png",
  "text": "Launch promo",
  "position": "sample_position",
  "opacity": 40,
  "font_size": 50,
  "color": "#38bdf8",
  "format": "png",
  "dryrun": true
}'

Send JSON payloads from back-end jobs, queues, or workers.

Parameters

Query Parameters

Name	Type	Description
url	string
text	string	Watermark text.
position	string	Corner position (top-left/top-right/bottom-left/bottom-right).
opacity	number	Opacity 0-1.
font_size	integer	Font size in px.
color	string	Text color.
format	string
dryrun	boolean

All helper calls accept your Dataczar key via the ak query parameter. Need one? Create or copy a key on Dataczar Connect and drop it into each request.

Responses

Status 200

Image transformed successfully.

"Binary image stream unless dryrun=true (JSON metadata)."

Examples

Request

"GET /img/add-watermark?url=https://example.com/a.jpg&dryrun=1"

Response

{
  "ok": true,
  "data": {
    "operation": "add-watermark"
  },
  "meta": {
    "dryrun": true
  }
}

Test Contracts

[
  {
    "name": "add-watermark_dryrun",
    "method": "GET",
    "params": {
      "url": "https://example.com/a.jpg",
      "dryrun": true
    },
    "expect": {
      "operation": "add-watermark"
    }
  }
]

API key

HTTP method

File uploads (multipart form-data)

Attach PDFs or images as multipart fields. We'll fill in the field names for you.

Files

file — Source image

Query parameters

url optionaltext optionalposition optionalopacity optionalfont_size optionalcolor optionalformat optionaldryrun optional

Body parameters

We'll send these as JSON for POST/PUT/PATCH requests and as query params for GET.