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

# 요청 한도

> X 개발자 제품 전반에 걸친 API 요청 한도를 이해합니다

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

***

<div id="rate-limits-by-product">
  ## 제품별 요청 한도
</div>

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

<CardGroup cols={3}>
  <Card title="X API v2" icon="square-x-twitter" href="/ko/x-api/fundamentals/rate-limits">
    15분 단위의 시간 창을 기준으로 엔드포인트별 요청 한도가 적용됩니다. 자세한 표와 복구 방법을 확인하세요.
  </Card>

  <Card title="Enterprise API" icon="building" href="/ko/x-api/enterprise-gnip-2.0/fundamentals/rate-limits">
    엔터프라이즈 계약과 데이터 패키지를 기반으로 맞춤형 요청 한도가 적용됩니다.
  </Card>

  <Card title="X Ads API" icon="rectangle-ad" href="/ko/x-ads-api/fundamentals/rate-limiting">
    광고 관리 및 분석 엔드포인트에 특화된 요청 한도가 적용됩니다.
  </Card>
</CardGroup>

***

<div id="how-rate-limits-work">
  ## 요청 한도 동작 방식
</div>

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

***

<div id="checking-your-limits">
  ## 요청 한도 확인
</div>

모든 API 응답에는 현재 요청 한도(rate limit) 상태를 나타내는 헤더가 포함되어 있습니다:

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

| Header                   | Description            |
| :----------------------- | :--------------------- |
| `x-rate-limit-limit`     | 현재 윈도 내에서 허용되는 최대 요청 수 |
| `x-rate-limit-remaining` | 현재 윈도 내에서 남아 있는 요청 수   |
| `x-rate-limit-reset`     | 제한이 초기화되는 유닉스 타임스탬프    |

***

<div id="rate-limit-errors">
  ## Rate limit 오류
</div>

요청 rate limit을 초과하면 **429 Too Many Requests** 응답을 받습니다:

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

***

<div id="best-practices">
  ## 모범 사례
</div>

<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">
    실시간 데이터의 경우 검색 엔드포인트를 폴링하는 대신 필터링된 스트림을 사용하세요.
  </Card>
</CardGroup>

***

<div id="next-steps">
  ## 다음 단계
</div>

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

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