Skip to main content
속도 제한은 주어진 기간 내에 보낼 수 있는 API 요청 수를 제어합니다. 이는 플랫폼 전반의 공정한 사용과 시스템 안정성을 보장합니다.

제품별 속도 제한

각 X API 제품은 고유한 속도 제한 방식을 가집니다:

X API v2

15분 기준 윈도우에 기반한 엔드포인트별 제한입니다. 자세한 표와 복구 팁을 확인하세요.

Enterprise API

엔터프라이즈 계약 및 데이터 패키지에 기반한 맞춤형 제한입니다.

X Ads API

광고 관리 및 분석 엔드포인트 전용 제한입니다.

속도 제한 작동 방식


제한 확인

모든 API 응답에는 현재 속도 제한 상태를 보여주는 헤더가 포함됩니다:

속도 제한 오류

속도 제한을 초과하면 429 Too Many Requests 응답을 받습니다:

모범 사례

응답 캐싱

API 응답을 로컬에 저장하여 동일한 데이터에 대한 반복 요청을 줄이세요.

지수 백오프 사용

속도 제한에 걸리면 재시도 전 대기하세요. 각 재시도마다 대기 시간을 두 배로 늘리세요.

헤더 확인

속도 제한 헤더를 모니터링하여 제한에 미리 대비하세요.

스트리밍 사용

실시간 데이터의 경우 검색 엔드포인트 폴링 대신 filtered stream을 사용하세요.

다음 단계

엔드포인트별 자세한 속도 제한 표는 해당 API의 속도 제한 페이지를 참조하세요: