Rate Limits & Quotas¶
Rate Limits¶
Per-minute rate limits based on your API key tier:
| Endpoint | Free | Pro |
|---|---|---|
POST /shorten |
10/min | 60/min |
GET /{short_id} |
100/min | 100/min |
GET /links/{id}/analytics |
30/min | 120/min |
GET /links/{id}/analytics/summary |
30/min | 120/min |
Rate-limited responses return 429 Too Many Requests with a Retry-After header.
Monthly Quotas¶
| Metric | Free | Pro |
|---|---|---|
| Links created | 100 | Unlimited |
| Hits served | Unlimited (tracked) | Unlimited (tracked) |
| Webhook deliveries | 1,000 | 50,000 |
When a quota is exceeded:
- Link creation: Returns
403with{"detail": "Monthly link creation limit reached", "limit": 100, "current": 100}. - Webhook deliveries: Delivery is skipped and logged as failed with error
"quota exceeded". - Hits: Never limited — existing links always work.
Check Your Usage¶
See the GET /usage endpoint for response details.