Rate Limits

Understand API rate limiting and how to handle it.

Limits by Plan

Plan	Requests/Hour	Writes/Day
Free	100	50
Pro	500	200
Max	1,000	500
Business	2,000	1,000

Handling 429 Responses

When you exceed the rate limit, the API returns HTTP 429. Implement exponential backoff:

import time

def api_call_with_retry(url, headers, max_retries=3):
    for attempt in range(max_retries):
        response = requests.get(url, headers=headers)
        if response.status_code == 429:
            wait = 2 ** attempt  # 1s, 2s, 4s
            time.sleep(wait)
            continue
        return response
    raise Exception("Rate limit exceeded after retries")