Rate Limits - Factagora

Overview

The Factagora API enforces rate limits to ensure fair usage and service stability. Limits vary by endpoint type.

Endpoint type	Limit
Light endpoints (`/fact-search`, `/claims/detect`, `/crawl`, `/fingerprint/detect`)	600 req/min per API key
Heavy endpoints (`/fact-checker`, `/evidence-finder`, `/deep-research`, `/timeseries`, `/causality-graph`, `/ingest`, `/fingerprint/embed`)	60 req/min per API key

Response Headers

Every API response includes the following headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed per minute
`X-RateLimit-Remaining`	Remaining requests in the current window
`X-RateLimit-Reset`	Unix timestamp when the current window resets
`Retry-After`	Seconds to wait before retrying (only on 429 responses)

Rate Limit Exceeded

When you exceed the rate limit, the API returns a 429 Too Many Requests response:

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Try again in 30s",
  "statusCode": 429
}

Handling Rate Limits

Use the Retry-After header to wait the appropriate amount of time before retrying:

import requests
import time

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

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

    return response

async function requestWithRetry(url: string, headers: Record<string, string>) {
  const response = await fetch(url, { headers });

  if (response.status === 429) {
    const retryAfter = Number(response.headers.get("Retry-After") ?? 60);
    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
    return requestWithRetry(url, headers);
  }

  return response;
}

If you consistently hit rate limits, consider batching requests or upgrading your plan. See Credits & Pricing for details.