Shortimize API
Shortimize API provides endpoints for managing and tracking social media accounts and videos.
Rate Limits
All API endpoints are rate limited per user. Rate limits vary by plan and endpoint:
| Plan | Standard endpoints | Tracking & History endpoints |
|---|---|---|
| Limited (trial) | 5 requests per minute | 5 requests per minute |
| Basic | 15 requests per minute | 15 requests per minute |
| Premium | 30 requests per minute | 120 requests per minute |
When rate limited, you'll receive a 429 Too Many Requests response. Check the RateLimit-* headers for limit status.
When you exceed a limit you get 429 with a Retry-After header giving the whole number of seconds to wait. That is the time left in the current window rather than a fixed minute, so a request rejected near the end of a window gets a short wait. The same number is in RateLimit-Reset, and RateLimit-Limit / RateLimit-Remaining show your allowance and what is left of it. Limits are per organisation, so all API keys in one organisation share them.
Tags
Account Management
Manage and track social media accounts
Video Management
Manage and track video content
Collection Management
Organize accounts and videos into collections
Organisation Management
Organisation-wide metrics and historical data
Statistics
Get aggregated statistics and counts
Data Operations
Refresh and update tracked data
Authentication
API authentication and validation
Integration
MCP server and integration endpoints