Rate Limits

Rate Limits

PropTechUSA API uses rate limiting to ensure fair usage and system stability.

Default Limits

Plan	Requests/Minute	Requests/Day

Free	60	1,000
Pro	300	10,000
Enterprise	1,000	Unlimited

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1705312800

Handling Rate Limits

When you exceed the rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 60 seconds.",
    "retry_after": 60
  }
}

Best Practices

Implement exponential backoff

async function fetchWithRetry(fn: () => Promise<any>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error: any) {
      if (error.status === 429) {
        const retryAfter = error.headers['retry-after'] || Math.pow(2, i);
        await sleep(retryAfter * 1000);
      } else {
        throw error;
      }
    }
  }
}

Cache responses where appropriate

Batch requests when possible

Use webhooks instead of polling