Rate Limits

To control the volume of data retrieved from Estate intel's data bank, we placed a limit on the number of requests that can be made within a period of time.

If you need a higher or custom rate limits, kindly request custom features.

ei API Limits - Free

Per minute	2 requests
Per 30 days	10 requests

ei API Limits - Paid

Per minute	60 requests
Per 30 days	86,400 requests

Response Headers and Status Code

The following headers are returned with each response, letting you know the numbers of requests remaining and when the limit will reset:

429 Too Many Requests will be returned as staus code when rate limit is exceeded.

Response Headers

X-RateLimit-Limit-Per-Minute integer	Number of requests you can make per minute.
X-RateLimit-Remaining-Per-Minute integer	Number of requests remaining in the current minute.
X-RateLimit-Limit-Per-Month integer	Number of requests you can make per 30 days (monthly).
X-RateLimit-Remaining-Per-Month integer	Number of requests remaining in the current month.
Retry-After integer	Number of seconds to wait before making the next request. Appears when you exceed your rate limit.
X-RateLimit-Reset integer	Unix timestamp of Retry-After. With this, you can get the exact datetime you can make the next request.

Response Format

{
  "message": "Too many attempts. Try again after 12 seconds"
}

Headers Format

{
  "X-RateLimit-Limit-Per-Minute": 2,
  "X-RateLimit-Remaining-Per-Minute": 0,
  "X-RateLimit-Limit-Per-Month": 10,
  "X-RateLimit-Remaining-Per-Month": 8,
  "Retry-After": 12,
  "X-RateLimit-Reset": 1731759153,
}

How to Avoid Rate Limiting

The following tips help you reduce the possibilities of being rate limited:

Caching

Cache responses on your site, so that when your users requests for the same data, you load the stored response instead of sending another request to the ei API.

Spread out requests

Do not make too many requests at once; instead, spread them out over a few seconds.

Priotize your requests

For example, you may want to priotize the requests of your premium users over that of your free users.

Reach out to us

If you are accessing the free API, you need to request higher rate limits.