API Rate Limits
Recruitly applies rate limits to API requests to ensure fair usage and platform stability for all users. Your rate limit depends on your current subscription plan.
For the complete API documentation, visit: https://recruitly.dev
Rate Limits by Plan
| Plan | Daily API Calls | Best For |
|---|---|---|
| Free | 100 / day | Testing and evaluation |
| Solo | 1,000 / day | Individual recruiters with light integrations |
| Professional | 10,000 / day | Teams with active integrations and automations |
| Enterprise | Unlimited | High-volume operations and custom applications |
You can check your current plan in Settings → Subscription within the Recruitly app.
How Rate Limits Work
- Rate limits are counted per day and reset at the start of each calendar day
- Every API request (GET, POST) counts toward your daily limit
- The limit applies to your entire account, not per API key — if you have multiple keys, they share the same quota
What Happens When You Hit the Limit
When you exceed your daily API call limit, the API returns a 400 Bad Request response with a message:
{
"message": "You have exceeded your usage limit. Please contact support if you need higher limits."
}
Subsequent requests will continue to receive this error until your limit resets the next day.
Tips to Stay Within Your Limits
Cache Responses
Store data locally instead of fetching the same records repeatedly. For example, cache your list of sectors and industries rather than requesting them before every form load.
Batch Your Operations
Group related operations together rather than making many small requests. For example, if you need to update multiple candidate records, batch them where possible.
Implement Exponential Backoff
If you receive a rate limit error, don’t retry immediately. Wait a short period and gradually increase the delay between retries:
- First retry: wait 1 second
- Second retry: wait 2 seconds
- Third retry: wait 4 seconds
- And so on…
Monitor Your Usage
Keep track of how many API calls your integrations make each day. If you’re consistently approaching your limit, it may be time to optimise your integration or upgrade your plan.
Need Higher Limits?
If your integration requires more API calls than your current plan allows, you have two options:
- Upgrade your plan — Visit recruitly.io/pricing to see available plans and upgrade instantly
- Contact support — Email support@recruitly.io to discuss your requirements and explore options
Frequently Asked Questions
Do read and write operations count equally?
Yes, every API request counts as one call toward your daily limit, regardless of the HTTP method.
Does the limit apply per API key or per account?
Per account. All API keys under your account share the same daily quota.
When does my limit reset?
Your daily limit resets at the start of each calendar day (UTC).
What if I need a temporary increase?
Contact support@recruitly.io — we can arrange temporary increases for data migrations or one-off bulk operations.
