Limits
post.buzz enforces three layers of limits:
- Platform limits — per-platform constraints on media and text, checked before a post is published so you get a clear error instead of a platform rejection.
- Plan quotas — per-plan resource ceilings (channels, posts/month, storage, AI actions, and more).
- Rate limits — only three exist in the whole system (see
below); there is no per-key request rate limit on
/v1.
How validation works
When you create a post (via the app or the REST API), the
post is validated against the destination platform's rules for its postType:
- Aspect ratio —
width / height. - Bitrate —
(fileSize × 8) / videoLength, in bps (shown as Mbps). - File count — how many images/videos a single post may attach.
- Resolution, duration, file size.
- Text length — per-platform and per-tier (e.g. X free vs. premium).
If anything fails, the API returns 400 with a message naming the constraint.
Ownership failures (referencing an account or media outside your
organization) return 403. See Errors.
Platform limits — quick reference
These are publish-time limits per platform and post type. They are independent of the API's upload ceilings, and the smaller of the two applies at upload time.
| Platform | Max files | Video max | Video duration | Image max |
|---|---|---|---|---|
| Instagram Post | 10 | 45 Mbps | 15 min | 8 MB |
| Instagram Reel | 1 | 45 Mbps | 15 min | — |
| Instagram Story | 1 | 100 MB | 60 s | 8 MB |
| TikTok Video | 1 | 1 GB | 10 min | — |
| TikTok Photo | 10 | — | — | 20 MB |
| YouTube Short | 1 | 5 GB | 3 min | — |
| YouTube Video | 1 | 5 GB | 4 h | — |
| 10 | 2 GB | 30 min | 5 MB | |
| X | 4 | 512 MB | 140 s / 600 s¹ | 5 MB |
| Facebook Post | 10 | 45 Mbps | 8 min | 4 MB |
| 1 | 2 GB | 15 min | 5 MB | |
| 1 / 10 gallery | 1 GB | 15 min | 20 MB | |
| Threads | 10 | 1 GB | — | 8 MB |
| Discord | 10 | 25 MB | — | 25 MB |
| Slack | 4 | 1 GB | — | 1 GB |
| Mastodon | 4 | 99 MB | — | 16 MB |
| Bluesky | 4 | — | — | — |
| Google Business | 1 | — | — | 5 MB |
¹ X video duration depends on account tier: 140 s (Free/Basic) or 600 s (Premium/Premium+).
For full per-post-type detail (aspect ratios, resolutions, text limits), see the individual platform pages.
Upload ceilings
The absolute largest files the Media API accepts, regardless of plan:
| Type | Absolute max |
|---|---|
| Image | 25 MB |
| Video | 100 MB |
| Document | 100 MB |
Your plan's maxFileSize (see below) may be lower; the effective limit is
the smaller of the two, and oversized uploads return
413 { "error": { "code": "too_large", ... } }.
Don't confuse upload ceilings with publish-time limits. Some platforms accept larger videos at publish time (e.g. YouTube's 5 GB) — but you can only get media into post.buzz through an upload path capped at 100 MB for video.
Plan quotas
Your plan determines resource ceilings. These apply to the whole organization.
| Free | Starter | Creator | Pro | Business | Agency | |
|---|---|---|---|---|---|---|
| Members | 1 | 1 | 3 | 5 | 10 | 25 |
| Workspaces | 1 | 1 | 2 | 5 | 10 | 25 |
| Channels (accounts) | 3 | 5 | 10 | 20 | 40 | 100 |
| Posts / month | 30 | Unlimited* | Unlimited* | Unlimited* | Unlimited* | Unlimited* |
| X posts / month | 30 | 100 | 250 | 750 | 2,000 | 5,000 |
| Auto-DMs / month | 10 | 100 | 500 | 2,000 | 7,500 | 25,000 |
| Auto-comments / month | 25 | 250 | 1,000 | 5,000 | 15,000 | 50,000 |
| Link-in-bio pages | 1 | 1 | 2 | 5 | 10 | 25 |
| Agents | 1 | 3 | 5 | 10 | 20 | 50 |
| AI actions / month | 100 | 500 | 1,500 | 5,000 | 15,000 | 50,000 |
| Image generations / month | 5 | 25 | 75 | 200 | 500 | 1,500 |
| Video credits / month | 0 | 5 | 10 | 20 | 40 | 80 |
| Media storage | 1 GB | 5 GB | 15 GB | 50 GB | 150 GB | 500 GB |
| Max image size | 10 MB | 25 MB | 25 MB | 25 MB | 25 MB | 25 MB |
| Max video size | 25 MB | 100 MB | 100 MB | 100 MB | 100 MB | 100 MB |
* Unlimited publishing is subject to fair use and social-platform API limits.
Paid plans (Starter through Agency) include a 7-day trial. A null quota
value means unlimited. Storage — not upload count — is the metered media
quantity. The per-plan maxFileSize can be lower than the absolute ceiling
but never higher.
Check your live numbers any time via GET /v1/organization (limits) and
GET /v1/usage (posts this month + credits).
Quota reset windows
- Post quotas (
postsThisMonth/ X posts) are metered on your subscription billing period — they reset when the period renews. If the organization has no subscription period, the calendar month is used instead. - Other monthly quotas (auto-DMs, auto-comments, AI actions, image generations, video credits) reset at the start of each UTC month.
Rate limits
There is no per-key or per-request HTTP rate limit on /api/v1/* — no
limiter sits in front of the REST surface. Only three things in the system
return 429:
| Limit | Scope | Value | On breach |
|---|---|---|---|
Public AI generator (POST /api/public/generate) | Per IP, per UTC day | 5 generations | 429 + Retry-After: <seconds to UTC midnight> |
Insight refresh (POST /v1/{posts,accounts}/{id}/analytics/refresh) | Per account, rolling 24 h | 3 refreshes (default; 0 disables) | 429 rate_limited + next-slot time in the message |
AI chat (POST /api/chat/stream) | Session (AI quota) | Plan-dependent | 429 |
Internal-only (not REST-facing): comment automation has hourly per-platform caps (Instagram 190, Facebook 100, Threads 50, others 50).