TurbineHub API Rate Limits & Request Guidelines
This document outlines the request limits and best practices for interacting with the TurbineHub API to ensure optimal performance and reliability.
API Rate Limits
To maintain stability and equitable usage, TurbineHub enforces the following rate limits:
Project Data
60
5,000
Financial Data
45
3,500
GIS & Mapping
30
2,500
Risk & Analytics
20
1,500
Market Data
25
2,000
Administrative
15
1,000
All rate limits apply per API key.
Exceeding Rate Limits
When you exceed the above limits, the API returns an HTTP status code 429 Too Many Requests. The response body will include:
{
"error": "Rate limit exceeded",
"retry_after": 60
}The retry_after field indicates the number of seconds to wait before making another request.
Best Practices
To efficiently manage your API requests:
Implement exponential backoff when encountering rate limit errors.
Cache responses to reduce unnecessary API calls.
Monitor your request usage to avoid hitting daily caps.
Contact Support to request higher rate limits for enterprise needs.
Requesting Rate Limit Increases
To request an increased API rate limit, please contact our support team at api-support@turbinehub.com with:
Your API key
Requested rate limits
Brief justification for the increase
Requests are typically reviewed and processed within 48 hours.