> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-e187ed14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 속도 제한

> 앱 수준과 사용자 수준 제한, 응답 헤더, 재시도 모범 사례를 포함하여 액세스 티어와 엔드포인트 전반의 X API 속도 제한을 이해하세요.

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

***

## 제품별 속도 제한

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

<CardGroup cols={3}>
  <Card title="X API v2" icon="square-x-twitter" href="/x-api/fundamentals/rate-limits">
    15분 기준 윈도우에 기반한 엔드포인트별 제한입니다. 자세한 표와 복구 팁을 확인하세요.
  </Card>

  <Card title="Enterprise API" icon="building" href="/x-api/enterprise-gnip-2.0/fundamentals/rate-limits">
    엔터프라이즈 계약 및 데이터 패키지에 기반한 맞춤형 제한입니다.
  </Card>

  <Card title="X Ads API" icon="rectangle-ad" href="/x-ads-api/fundamentals/rate-limiting">
    광고 관리 및 분석 엔드포인트 전용 제한입니다.
  </Card>
</CardGroup>

***

## 속도 제한 작동 방식

| 개념          | 설명                                     |
| :---------- | :------------------------------------- |
| **시간 윈도우**  | 대부분의 제한은 15분마다 재설정됩니다                  |
| **사용자별 제한** | OAuth 1.0a 또는 OAuth 2.0 사용자 토큰 사용 시 적용 |
| **앱별 제한**   | Bearer Token(앱 전용) 인증 사용 시 적용          |
| **엔드포인트별**  | 각 엔드포인트마다 고유한 제한이 있습니다                 |

***

## 제한 확인

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

```
x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800
```

| 헤더                       | 설명                    |
| :----------------------- | :-------------------- |
| `x-rate-limit-limit`     | 현재 윈도우에서 허용되는 최대 요청 수 |
| `x-rate-limit-remaining` | 현재 윈도우에서 남은 요청 수      |
| `x-rate-limit-reset`     | 제한이 재설정되는 Unix 타임스탬프  |

***

## 속도 제한 오류

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

```json theme={null}
{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}
```

***

## 모범 사례

<CardGroup cols={2}>
  <Card title="응답 캐싱" icon="database">
    API 응답을 로컬에 저장하여 동일한 데이터에 대한 반복 요청을 줄이세요.
  </Card>

  <Card title="지수 백오프 사용" icon="clock-rotate-left">
    속도 제한에 걸리면 재시도 전 대기하세요. 각 재시도마다 대기 시간을 두 배로 늘리세요.
  </Card>

  <Card title="헤더 확인" icon="list-check">
    속도 제한 헤더를 모니터링하여 제한에 미리 대비하세요.
  </Card>

  <Card title="스트리밍 사용" icon="signal-stream">
    실시간 데이터의 경우 검색 엔드포인트 폴링 대신 filtered stream을 사용하세요.
  </Card>
</CardGroup>

***

## 다음 단계

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

* [X API v2 속도 제한](/x-api/fundamentals/rate-limits)
* [X Ads API 속도 제한](/x-ads-api/fundamentals/rate-limiting)