SmartRecruiters · Rate Limits

Smartrecruiters Rate Limits

SmartRecruiters enforces both a per-second request rate and a concurrency cap on its API. Standard endpoints allow up to 10 requests per second; job-publication and offer-document endpoints are capped at 2 requests per second. Most endpoints permit up to 8 simultaneous requests; GET /candidates is restricted to a single concurrent request. Each API credential is treated as a separate user for rate-limit accounting. Exceeding either limit returns HTTP 429.

4 Limits Throttle: 429
Human ResourcesRecruitingApplicant TrackingRate Limiting

Limits

Standard Endpoints (Request Rate) api-credential
requests_per_second · second
10
Default rate limit applied to most SmartRecruiters API endpoints.
Job Publication / Offer Documents (Request Rate) api-credential
requests_per_second · second
2
Lower per-second cap for job-publication and offer-document endpoints.
Standard Endpoints (Concurrency) api-credential
concurrent_requests
8
Maximum simultaneous in-flight requests across most endpoints.
GET /candidates (Concurrency) api-credential
concurrent_requests
1
GET /candidates is restricted to one concurrent request per credential.

Policies

Per-Credential Accounting
Each API credential is treated as a separate user for rate-limit tracking; sharing a credential across services compounds the same caps.
Distribute Load
SmartRecruiters recommends distributing requests throughout the day rather than clustering them at peak times.
Long Timeouts
Set client request timeouts to a minimum of 128 seconds to avoid spurious retries under concurrency pressure.
Bulk via Reporting API
Use the SmartRecruiters Reporting API for bulk data retrieval; it is optimized for high-volume transfers and bypasses some of the standard endpoint constraints.
Backoff on 429
On HTTP 429, implement exponential backoff with jitter and consult X-RateLimit-* headers to reschedule.

Sources