Rate Limits & Plans
API rate limits and usage quotas per plan.
Rate Limits
API requests are rate limited per minute based on your workspace plan:
| Plan | Requests/min |
|---|---|
| Free | 30 |
| Pro | 500 |
If you exceed the limit, the API returns a 429 Too Many Requests response.
Monthly Quotas
Each plan includes monthly usage quotas. When a quota is exceeded, the API returns 402 Payment Required.
| Feature | Free | Pro |
|---|---|---|
| API calls/month | 500 | Unlimited |
| Scrape jobs/month | 10 | Unlimited |
| Posts stored | 200 | 10,000 |
| Schedules | 5 | Unlimited |
| Alerts | 5 | Unlimited |
| Team members | 1 | Unlimited |
| Data retention | 7 days | Unlimited |
| Brand monitors | 0 | 1 |
Plan-Gated Features
Some API features require a Pro plan:
- Sentiment analysis (
/analytics/sentiment) — Pro only. Returns402on Free. - Brand monitoring (
/brand-monitors) — Pro only. Free plan has no brand monitoring. - Export formats — Free: CSV only. Pro: CSV + JSON + Parquet.
Check your current usage via the dashboard Settings > Billing page.
Checking Usage Programmatically
You can check your current usage and limits via the API:
bash
curl https://api.sentrasa.com/api/v1/workspaces/{workspace_id}/billing/limits \
-H "X-API-Key: rp_your_api_key"This returns your plan limits, current usage, and percentage used for each quota.