Rate Limits
한도는 두 종류뿐입니다 — IP 기준과 키 기준. 창은 60초 고정이고 플랜별 차등은 없습니다.
한도
| 기준 | 한도 | 설명 |
|---|---|---|
| API 키당 | 분당 60회 | 읽기 엔드포인트 5개가 한 버킷을 공유합니다(엔드포인트별로 따로 세지 않음). |
| IP당 | 분당 300회 | 키 검증보다 먼저 걸립니다 — 잘못된 키를 대량으로 던지면 401이 아니라 429를 먼저 만납니다. |
| 일일 | 없음 | 하루 총량 제한은 두지 않습니다. |
| 플랜별 차등 | 없음 | API 자체가 Pro 전용이라 플랜별 등급 표가 없습니다. |
API 키당
- 한도
- 분당 60회
- 설명
- 읽기 엔드포인트 5개가 한 버킷을 공유합니다(엔드포인트별로 따로 세지 않음).
IP당
- 한도
- 분당 300회
- 설명
- 키 검증보다 먼저 걸립니다 — 잘못된 키를 대량으로 던지면 401이 아니라 429를 먼저 만납니다.
일일
- 한도
- 없음
- 설명
- 하루 총량 제한은 두지 않습니다.
플랜별 차등
- 한도
- 없음
- 설명
- API 자체가 Pro 전용이라 플랜별 등급 표가 없습니다.
알아둘 점
- 키당 한도는 엔드포인트별로 나뉘지 않습니다 — 읽기 엔드포인트 전체가 분당 60회 한 버킷을 함께 씁니다.
- IP 한도는 키 검증보다 먼저 걸립니다 — 잘못된 키를 대량으로 던지면 401 이 아니라 429 를 먼저 만납니다.
- 플랜별 차등 한도는 없습니다(API 자체가 Pro 전용이라 등급을 나누지 않습니다).
- 일일 한도는 없습니다.
- 모든 응답에 X-RateLimit-Limit/Remaining/Reset 헤더가 붙습니다(키당 버킷 기준). 429 에는 Retry-After(초)가 함께 옵니다 — 그 초만큼 기다렸다 다시 부르세요.
초과했을 때
응답
HTTP/1.1 429 Too Many Requests
{
"error": "Rate limit exceeded"
}지수 백오프로 재시도하세요
지수 백오프(재시도 간격을 1초 → 2초 → 4초처럼 2배씩 늘리는 방식)로 다시 호출하세요. 창이 60초이므로 대개 1분 안에 풀립니다. 같은 데이터를 반복해서 읽지 말고limit=50 으로 한 번에 많이 받아 캐싱하는 편이 한도에 훨씬 유리합니다.