Understand usage limits, quotas, and how to handle rate limiting in your application.
Each plan includes a monthly quota of screenshots. Once reached, requests will be rejected with a 429 error.
Limits reset on the 1st day of each month at 00:00 UTC. Unused screenshots do not roll over.
Limits are enforced per user account, not per API key. All API keys share the same quota.
Usage is tracked in real-time. Check your current usage via the API or dashboard.
When you exceed your monthly quota, the API returns a 429 Too Many Requests error:
{
"success": false,
"error": {
"message": "Usage limit reached",
"code": "USAGE_LIMIT_REACHED"
}
}Check usage before critical operations
Use the usage endpoint to verify available quota
Implement graceful degradation
Handle 429 errors and show appropriate messages to users
Cache screenshots when possible
Avoid re-capturing the same URL unnecessarily
Monitor usage trends
Use analytics to predict when you'll need to upgrade
curl https://snapshotai.dev/api/v1/usage/current \
-H "Authorization: Bearer YOUR_API_KEY"{
"success": true,
"data": {
"period": "2024-01",
"count": 847,
"limit": 1000,
"percentage": 84.7,
"remaining": 153
}
}View detailed usage analytics at: Dashboard → Usage
Running out of screenshots? Upgrade to a higher tier for more capacity and advanced features.
Each plan has different rate limits to balance performance and fair usage:
| Plan | Monthly Quota | Rate Limit | Overage Cost |
|---|---|---|---|
| Free | 100/month | 2 requests/min | Upgrade required |
| Basic | 2,000/month | 40 requests/min | $2 per 1,000 |
| Growth | 10,000/month | 80 requests/min | $1.50 per 1,000 |
| Scale | 50,000/month | 150 requests/min | $0.75 per 1,000 |