API Reference

Limits & Quotas

Daily caps, character limits, media specs

Daily Post Limits

To safeguard your connected accounts and stay compliant with each social network's guidelines, CodivUpload enforces publishing caps using a rolling 24-hour window per platform. Once a specific account on a given network hits its daily ceiling, any further publish attempts for that account are rejected until the window resets.

PlatformDaily Limit (per account)
X (Twitter)50
YouTube10
Instagram50
Facebook25
LinkedIn150
TikTok15
Threads50
Pinterest20
Bluesky50
Google Business Profile10
Snapchat20

How Limits Work

What counts: Only successful publishes recorded in the last 24 hours for that specific account/network combination. Failed or queued posts are not counted.

Scope: Limits apply per connected social media account, not per CodivUpload user or workspace. Each linked account gets its own independent allowance.

Scheduled posts: Limits are re-verified at the moment of execution. If the cap has already been reached when a scheduled post is due, publishing is deferred and the post is marked as rate-limited for automatic retry.

Example: Suppose you manage 5 brand profiles, each with its own TikTok account. Every TikTok account receives the full 15-post daily allowance independently — giving you a combined capacity of 5 × 15 = 75 TikTok posts per day across all profiles.

Rate Limit Response

When a daily limit is reached, the API returns a 429 Too Many Requests response with detailed violation info:

{
  "success": false,
  "error": "Post verification failed",
  "violations": [{
    "platform": "instagram",
    "type": "hard_cap",
    "message": "Daily cap reached for instagram: 50/50 in last 24h",
    "used_last_24h": 50,
    "cap": 50
  }]
}

Character Limits

Text is validated before publishing. Set auto_truncate: true to auto-trim instead of rejecting.

PlatformPostTitleCommentAlt Text
X (Twitter)2801,000
YouTube5,000100
Instagram2,2002,1961,000
Facebook63,206255
LinkedIn3,0004001,250
TikTok2,200
Threads500
Pinterest500100500
Bluesky3001,000
Google Business Profile1,500255
Snapchat16045

Media Limits

PlatformMax File SizeMax DurationMax ImagesVideo Formats
X (Twitter)1 GB4 hr4MP4, MOV
YouTube256 GB12 hrMP4, MOV, AVI, WMV, FLV, WEBM, 3GP
Instagram300 MB15 min10MP4, MOV
Facebook1 GB4 hr10MP4, MOV
LinkedIn5 GB10 min9MP4
TikTok4 GB10 min35MP4, MOV, WEBM
Threads1 GB5 min10MP4, MOV
Pinterest1 GB15 min5MP4
Bluesky100 MB1 min4MP4
Google Business Profile75 MB30 sec1MP4
Snapchat1 GB5 min1MP4

YouTube API Quota

Each operation consumes units from the project's daily quota (10,000 units/day):

OperationUnit Cost
Video upload (videos.insert)100
Custom thumbnail (thumbnails.set)50
Country restrictions (videos.update)50
First comment (commentThreads.insert)50
Caption upload (captions.insert)400
Typical video with thumbnail = 150 units ≈ 66 videos/day. Use your own Google Cloud credentials for a dedicated 10,000 unit quota. See YouTube BYOP Guide →