제품별 속도 제한
각 X API 제품은 고유한 속도 제한 방식을 가집니다:X API v2
15분 기준 윈도우에 기반한 엔드포인트별 제한입니다. 자세한 표와 복구 팁을 확인하세요.
Enterprise API
엔터프라이즈 계약 및 데이터 패키지에 기반한 맞춤형 제한입니다.
X Ads API
광고 관리 및 분석 엔드포인트 전용 제한입니다.
속도 제한 작동 방식
| 개념 | 설명 |
|---|---|
| 시간 윈도우 | 대부분의 제한은 15분마다 재설정됩니다 |
| 사용자별 제한 | OAuth 1.0a 또는 OAuth 2.0 사용자 토큰 사용 시 적용 |
| 앱별 제한 | Bearer Token(앱 전용) 인증 사용 시 적용 |
| 엔드포인트별 | 각 엔드포인트마다 고유한 제한이 있습니다 |
제한 확인
모든 API 응답에는 현재 속도 제한 상태를 보여주는 헤더가 포함됩니다:| 헤더 | 설명 |
|---|---|
x-rate-limit-limit | 현재 윈도우에서 허용되는 최대 요청 수 |
x-rate-limit-remaining | 현재 윈도우에서 남은 요청 수 |
x-rate-limit-reset | 제한이 재설정되는 Unix 타임스탬프 |
속도 제한 오류
속도 제한을 초과하면 429 Too Many Requests 응답을 받습니다:모범 사례
응답 캐싱
API 응답을 로컬에 저장하여 동일한 데이터에 대한 반복 요청을 줄이세요.
지수 백오프 사용
속도 제한에 걸리면 재시도 전 대기하세요. 각 재시도마다 대기 시간을 두 배로 늘리세요.
헤더 확인
속도 제한 헤더를 모니터링하여 제한에 미리 대비하세요.
스트리밍 사용
실시간 데이터의 경우 검색 엔드포인트 폴링 대신 filtered stream을 사용하세요.