Limits
Limits apply per account: all its keys share one budget. GET /api/v1/account returns the exact numbers of your plan in limits.
Request rate
- 60 requests a minute per account, for all its keys together.
- Resumable uploads have budgets of their own: 240 upload requests and 1200 parts a minute.
- Responses carry
X-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Reset(seconds until the budget refills). - Above the limit: 429
RATE_LIMITEDwithRetry-After.
File sizes and storage
| What | Limit |
|---|---|
| Image | Up to 10 MB on the free plan (limits.maxImageBytes) and 40 megapixels; Pro has no limit for one file, only the storage and the server’s 64 MB ceiling. |
| Video | Up to 100 MB on the free plan (limits.maxVideoBytes); Pro has no limit for one file, only the storage and the server’s 4 GB ceiling. |
| Account storage | The plan’s quota (user.quotaBytes); above it: 413 QUOTA_EXCEEDED. |
More storage and larger files: see the plans.
Simultaneous uploads
- An account sends up to 2 files with
POST /uploadsand up to 3 parts at a time; more get 429UPLOAD_USER_BUSYwithRetry-After. - A busy server answers 503
UPLOAD_SERVER_BUSYwithRetry-After; nothing is stored. - A body that stops arriving is dropped: after 30 seconds for
POST /uploads, 20 seconds for a part (408UPLOAD_STALLED).
Other limits
| What | Limit |
|---|---|
| JSON body | 1 MB |
| Note | 200,000 characters |
| Title | 180 characters |
| Tags | up to 10, 1–32 characters each |
| File list | 25 per page |
| media-status | up to 25 ids per request |
| Resumable upload | 2 MB parts, up to 50 parts, up to 10 unfinished, 24 hours |
| Upload retries (Idempotency-Key) | at least 24 hours |
| Views by day | 1 to 90 days |
| Request log | the latest 100 from 30 days |