메인 콘텐츠로 건너뛰기
요청 한도는 일정 기간 동안 보낼 수 있는 API 요청 횟수를 제한합니다. 이를 통해 플랫폼 전반에서 공정한 사용과 시스템 안정성을 유지합니다.

​
제품별 요청 한도

각 X API 제품은 서로 다른 방식으로 요청 한도를 적용합니다:

X API v2

15분 단위의 시간 창을 기준으로 엔드포인트별 요청 한도가 적용됩니다. 자세한 표와 복구 방법을 확인하세요.

Enterprise API

엔터프라이즈 계약과 데이터 패키지를 기반으로 맞춤형 요청 한도가 적용됩니다.

X Ads API

광고 관리 및 분석 엔드포인트에 특화된 요청 한도가 적용됩니다.

​
요청 한도 동작 방식

개념설명
시간 창대부분의 요청 한도는 15분마다 초기화됩니다
사용자별 한도OAuth 1.0a 또는 OAuth 2.0 사용자 토큰을 사용할 때 적용됩니다
App별 한도Bearer 토큰(App 전용) 인증을 사용할 때 적용됩니다
엔드포인트별각 엔드포인트마다 별도의 한도가 있습니다

​
요청 한도 확인

모든 API 응답에는 현재 요청 한도(rate limit) 상태를 나타내는 헤더가 포함되어 있습니다: 
x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800
HeaderDescription
x-rate-limit-limit현재 윈도 내에서 허용되는 최대 요청 수
x-rate-limit-remaining현재 윈도 내에서 남아 있는 요청 수
x-rate-limit-reset제한이 초기화되는 유닉스 타임스탬프

​
Rate limit 오류

요청 rate limit을 초과하면 429 Too Many Requests 응답을 받습니다: 
{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

​
모범 사례

응답 캐시하기

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

지수 백오프 사용하기

레이트 리밋에 걸리면 재시도 전에 기다리세요. 재시도할 때마다 대기 시간을 두 배로 늘리세요.

헤더 확인하기

레이트 리밋 헤더를 모니터링해 한도에 도달하지 않도록 하세요.

스트리밍 사용하기

실시간 데이터의 경우 검색 엔드포인트를 폴링하는 대신 필터링된 스트림을 사용하세요.

​
다음 단계

엔드포인트별 상세 요청 한도 표는 사용 중인 API에 해당하는 요청 한도 페이지를 참조하세요.