Skip to main content

​
Overview

The MentionLab API implements rate limiting to ensure fair usage and maintain service stability for all users. Understanding these limits helps you design efficient integrations that avoid throttling.

​
Default Rate Limits

All accounts share the same default rate limits:
MetricLimit
Requests per Minute120
Burst Limit20
Burst limits define the maximum number of concurrent requests allowed within a 1-second window.
If you have a custom agreement with MentionLab, your rate limits may differ from the defaults listed here. Please refer to your agreement documentation for your specific limits.

​
Rate Limit Headers

Every API response includes headers to help you track your usage:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed in the current window
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the rate limit resets
Retry-AfterSeconds to wait before retrying (only on 429 responses)

​
Handling Rate Limits

When you exceed the rate limit, the API returns a 429 Too Many Requests response: 
{
  "statusCode": 429,
  "message": "Too many requests. Please retry after 30 seconds.",
  "error": "Too Many Requests"
}

​
Error Codes

CodeDescriptionAction
429Rate limit exceededWait for Retry-After seconds and retry
503Service temporarily unavailableWait 30 seconds and retry with backoff

​
Need Higher Limits?

Contact Sales

If you need higher rate limits for your use case, contact our sales team to discuss a custom agreement tailored to your requirements.