API Limits

At Geolocated.io, we employ rate and daily usage limits to ensure the consistent performance and reliability of our services for all users. These limits are designed to prevent system abuse that could affect service stability and are determined by your subscription plan. Rate limits restrict the number of requests that can be made per minute, while daily usage limits cap the total number of requests that can be made in a 24-hour period.

Rate Limits

To ensure optimal performance and service stability, Geolocated.io implements rate limits on API requests. This measure is crucial for managing sudden surges in traffic and maintaining service quality for all users. Here are key points about our rate limiting:

  • Global Rate Limits: Our rate limiting applies globally across all API endpoints. This means that if you have a limit of 3 requests per minute, making 3 requests to any combination of endpoints counts towards this limit.
  • Rate Limit Headers: For subscriptions subject to rate limits, API responses include three headers to help you monitor your usage:
    • RateLimit-Limit: The total number of requests permitted per minute under your current plan.
    • RateLimit-Remaining: The number of requests left for the current minute window.
    • RateLimit-Reset: The time (in epoch seconds) when the rate limit window resets.

Usage Limits

In addition to rate limits, each subscription plan comes with a daily request quota. Upon reaching this daily limit, further requests will be blocked until the reset time. To track your daily usage, the following headers are included in all responses:

  • Daily-Request-Limit: The total number of requests permitted per minute under your current plan.
  • Daily-Request-Remaining: The number of requests left for the current minute window.
  • Daily-Request-Reset: The time (in epoch seconds) when the rate limit window resets.

The daily usage limit provided by your subscription plan encompasses the cumulative count of requests across all API endpoints. This means if your plan includes access to all three API endpoints with a daily allowance of 500,000 requests, this quota applies to the total number of requests made to any combination of these endpoints.

Contents