속도 제한
속도 제한 방식
속도 제한은 계정 단위이며 초당 요청 수(QPS)로 측정됩니다. 상한은 크레딧 구매 이력 유무에 따라 결정되고, 상위 두 구독 등급에서 약간 더 높아집니다.
월간 상한이나 일간 상한은 없습니다 — 초당 상한만 넘지 않는다면 한 달 동안 얼마든지 크레딧을 사용할 수 있습니다.
스트림(계정 모니터링) 구독은 REST API와 별개입니다. 스트림 플랜에는 API 크레딧이나 더 높은 REST 속도 제한이 포함되지 않습니다: REST 호출은 크레딧으로 결제되며, 크레딧을 구매하기 전까지는 5초당 1 요청의 무료 등급 제한이 유지됩니다.
실제 제한
| 계정 상태 | 속도 제한 |
|---|---|
신규 계정 (결제 이력 없음) 0.2 req/s — API를 체험하기에 충분하고, 첫 충전을 유도합니다. | 5초당 1 요청 |
한 번이라도 크레딧을 구매한 적 있는 계정 일회성 크레딧 구매 한 번이면 충분하며, 구독은 필요하지 않습니다. | 20 req/s |
Starter · Builder · Pro 구독 이 플랜들은 처리량이 아니라 크레딧 지급량, 보너스, 크레딧 리턴으로 차별화됩니다. 지속적으로 더 높은 QPS가 필요하다면 아래의 Scale과 Business를 확인하세요. | 20 req/s |
Scale 구독 | 50 req/s |
Business 구독 | 500 req/s |
더 큰 수요 사용 사례와 예상 지속 req/s를 contact@twitterapi.io로 보내주세요. | 요청 시 |
플랜 선택 중? /subscribe에서 확인하세요 — Starter, Builder, Pro는 지급 크레딧, 충전 보너스 %, 롤링 크레딧 리턴에서 차이가 납니다. 20 req/s를 넘는 처리량이 지속적으로 필요하다면 상한이 올라가는 등급은 Scale(50 req/s)과 Business(500 req/s)입니다.
버스트 트래픽? 상한을 넘으면 HTTP 429가 반환됩니다 (Retry-After 헤더는 전송되지 않습니다). 약 1초 기다렸다가 지수 백오프로 재시도하면 됩니다 — 계정을 차단하지는 않습니다.