메인 콘텐츠로 건너뛰기

​
개요

Factagora API는 공정한 사용과 서비스 안정성을 보장하기 위해 요청 제한을 적용합니다. 엔드포인트 유형에 따라 한도가 다르게 적용됩니다.
엔드포인트 유형제한
검색 엔드포인트 (예: /fact-search, /search)API 키당 600 req/min
분석 엔드포인트 (예: /fact-checker, /evidence-finder, /generate, /deep-research, /timeseries, /causality-graph, /ingest)API 키당 60 req/min

​
응답 헤더

모든 API 응답에는 다음 헤더가 포함됩니다:
헤더설명
X-RateLimit-Limit분당 허용되는 최대 요청 수
X-RateLimit-Remaining현재 윈도우에서 남은 요청 수
Retry-After재시도 전 대기 시간(초) (429 응답에서만 제공)

​
요청 제한 초과

요청 제한을 초과하면 API가 429 Too Many Requests 응답을 반환합니다: 
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Try again in 30s",
  "statusCode": 429
}

​
요청 제한 처리

Retry-After 헤더를 사용해 적절한 시간을 기다린 후 재시도하세요: 
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
요청 제한에 지속적으로 걸린다면 요청을 묶어서 보내거나 플랜 업그레이드를 고려하세요. 자세한 내용은 크레딧 & 요금제를 참고하세요.