Rate Limits

x-ratelimit-limit: 300
x-ratelimit-remaining: 247
x-ratelimit-reset: 1743955260

{
  "error": "Rate limit exceeded"
}

import requests
import time


def api_request(url, headers, max_retries=3):
    for attempt in range(max_retries):
        res = requests.get(url, headers=headers)

        if res.status_code != 429:
            return res

        # Use reset header if available, otherwise exponential backoff
        reset = res.headers.get("x-ratelimit-reset")
        if reset:
            wait = max(int(reset) - int(time.time()), 1)
        else:
            wait = 2 ** attempt

        print(f"Rate limited. Waiting {wait}s before retry.")
        time.sleep(wait)

    raise Exception("Rate limit retries exhausted")

def check_rate_limit(response):
    remaining = int(response.headers.get("x-ratelimit-remaining", 0))
    if remaining < 10:
        print(f"Warning: only {remaining} requests remaining in this window")
    return remaining