Skip to main content
POST
/
post
/
youTubeWatermark
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.ayrshare.com/api/post/youTubeWatermark

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

Documentation Index

Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Available on plan.
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

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
​
Profile-Key
string
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

​
Body Parameters

​
mediaUrls
array
required
Array containing the watermark image URL. Only the first URL will be used.
​
timingType
string
required
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
​
offsetMs
number
required
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
​
durationMs
number
required
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.ayrshare.com/api/post/youTubeWatermark

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