Skip to main content

​
Overview

The FoxReach API enforces rate limits to ensure fair usage and platform stability. Rate limits are applied per API key using a sliding window counter.

​
Limits

PlanLimit
Default100 requests per minute per API key

​
Rate Limit Headers

Every API response includes rate limit information in the headers:
HeaderDescription
X-RateLimit-LimitMaximum requests allowed per minute
X-RateLimit-RemainingRequests remaining in the current window
X-RateLimit-ResetUnix timestamp when the current window resets
Example response headers: 
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1706140920

​
Exceeding the Limit

When you exceed the rate limit, the API returns a 429 Too Many Requests response: 
{
  "error": "Rate limit exceeded",
  "code": "rate_limit_exceeded",
  "details": {
    "limit": 100,
    "reset": 1706140920
  }
}
The response also includes a Retry-After header indicating how many seconds to wait: 
Retry-After: 42

​
Handling Rate Limits

​
Retry with Backoff

The simplest approach is to respect the Retry-After header: 
import requests
import time

def api_request(url, headers):
    response = requests.get(url, headers=headers)

    if response.status_code == 429:
        retry_after = int(response.headers.get("Retry-After", 60))
        time.sleep(retry_after)
        return api_request(url, headers)

    return response

​
Monitor Remaining Requests

Proactively slow down when you’re approaching the limit: 
remaining = int(response.headers.get("X-RateLimit-Remaining", 100))

if remaining < 10:
    time.sleep(1)  # Slow down

​
Batch Operations

Instead of making many individual requests, use pagination efficiently: 
# Fetch 100 leads at once instead of one at a time
curl "https://api.foxreach.io/api/v1/leads?pageSize=100" \
  -H "X-API-Key: otr_your_key"

​
Best Practices

  • Cache responses when possible to reduce the number of API calls
  • Use webhooks instead of polling for real-time updates
  • Batch operations to minimize the number of requests
  • Implement exponential backoff for retries after rate limit errors