Set YouTube Watermark

POSThttps://api.acme.com/api/post/youTubeWatermark

Available on Premium, Business, Enterprise plans.

Set a watermark image on your YouTube channel that will appear on all your videos. The watermark can be configured to appear at specific times during video playback.

Position is automatically set to bottom-right corner (YouTube API default)
All timing parameters timingType, offsetMs, and durationMs are required when setting a watermark
Watermarks apply to all videos on the channel (existing and future)
The watermark image must meet YouTube's watermark media guidelines
You must have proper permissions to manage the YouTube channel

Header Parameters

Authorizationstringrequired

API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

Profile-Keystring

Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Body Parameters

mediaUrlsarrayrequired

Array containing the watermark image URL. Only the first URL will be used.

timingTypestringrequired

When to show the watermark during video playback.

Available timingType options:

offsetFromStart - Show watermark starting from a specific time after video begins
offsetFromEnd - Show watermark starting from a specific time before video ends

offsetMsnumberrequired

Time offset in milliseconds. Must be a positive number.

For offsetFromStart: Time after video starts to show watermark
For offsetFromEnd: Time before video ends to show watermark

durationMsnumberrequired

How long to display the watermark in milliseconds. Must be a positive number.

curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{
  "mediaUrls": ["https://example.com/watermark.png"],
  "timingType": "offsetFromStart",
  "offsetMs": 15000,
  "durationMs": 30000
}' \
-X POST https://api.acme.com/api/post/youTubeWatermark

200

{
  "status": "success",
  "message": "Watermark set successfully",
  "mediaUrls": [
    "https://example.com/watermark.png"
  ],
  "timingType": "offsetFromStart",
  "offsetMs": 1000,
  "durationMs": 5000
}

400 - Invalid Image Dimensions

{
    "action": "post",
    "status": "error",
    "code": 140,
    "message": "The image aspect ratio must be between 1 and 1. Current image aspect ratio: 1085/723 (1.50). https://www.acme.com/docs/media-guidelines/youtube "
}

400 - Unsupported Format

{
    "status": "error",
    "code": 307,
    "message": "Media type 'image/webp' is not supported. "
}

403 - Permission Error

{
  "status": "error",
  "code": 250,
  "message": "The watermark cannot be set for this channel. Please check that you have proper permissions and the channel is valid."
}