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 Second10
Requests per Minute300
Requests per Hour10,000
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.
Enterprise plans have significantly higher rate limits to support high-volume integrations:
MetricLimit
Requests per Second100
Requests per Minute3,000
Requests per Hour100,000
Contact our sales team to learn more about enterprise plans and custom rate limit configurations.

​
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.