> ## 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.

# 사용량 및 과금

> API 사용량 추적 및 사용량 기반 과금 방식 이해하기

X API v2는 **pay-per-usage** 과금 방식을 사용합니다. 실제 API 사용량을 기준으로 요금이 부과되며, App 단위로 사용량이 추적됩니다.

***

<div id="how-billing-works">
  ## 과금 방식
</div>

| 개념         | 설명                                    |
| :--------- | :------------------------------------ |
| **크레딧 기반** | API 사용 전에 크레딧을 미리 구매하고, 사용할 때마다 차감됩니다 |
| **요청당 과금** | 엔드포인트별로 비용이 다릅니다                      |
| **실시간 추적** | 개발자 콘솔에서 사용량을 모니터링합니다                 |
| **상한 없음**  | 월간 한도 없이 필요한 만큼 사용할 수 있습니다            |

***

<div id="tracked-endpoints">
  ## 추적 대상 엔드포인트
</div>

다음 엔드포인트를 통해 조회한 포스트는 사용량에 포함됩니다:

| Category        | Endpoints                                                                                                                           |
| :-------------- | :---------------------------------------------------------------------------------------------------------------------------------- |
| **Post lookup** | [GET /2/tweets](/ko/x-api/posts/lookup/introduction)                                                                                |
| **Search**      | [Recent search](/ko/x-api/posts/search/introduction), [Full-archive search](/ko/x-api/posts/search/introduction)                    |
| **Streaming**   | [Filtered stream](/ko/x-api/posts/filtered-stream/introduction), [Filtered stream webhooks](/ko/x-api/webhooks/stream/introduction) |
| **Timelines**   | [User posts](/ko/x-api/posts/timelines/introduction), [User mentions](/ko/x-api/posts/timelines/introduction)                       |
| **Engagement**  | [Liked posts](/ko/x-api/posts/likes/introduction), [Bookmarks](/ko/x-api/posts/bookmarks/introduction)                              |
| **Lists**       | [List posts](/ko/x-api/lists/list-tweets/introduction)                                                                              |
| **Spaces**      | [Spaces lookup](/ko/x-api/spaces/lookup/introduction)                                                                               |

***

<div id="deduplication">
  ## 중복 제거
</div>

<Note>
  **일별 중복 제거**: 같은 게시물이 하루 동안 여러 쿼리에서 반환되더라도, 요금 청구 시 한 번만 집계됩니다.
</Note>

이는 다음을 의미합니다:

* 같은 게시물을 하루에 여러 번 조회 = 1회 청구
* 다음 날 다시 해당 게시물을 조회 = 추가 1회 청구
* 하나의 요청에서 서로 다른 게시물 = 각각 별도 청구

***

<div id="monitoring-usage">
  ## 사용량 모니터링
</div>

[개발자 콘솔](https://console.x.com)에서 사용량을 추적하세요:

| Metric             | Description        |
| :----------------- | :----------------- |
| **Total usage**    | 청구 기간 동안 조회된 포스트 수 |
| **By endpoint**    | 엔드포인트 유형별 세부 내역    |
| **By app**         | 개발자 앱별 사용량         |
| **Cost tracking**  | 실시간 비용 산정          |
| **Credit balance** | 잔여 선불 크레딧          |

***

<div id="managing-costs">
  ## 비용 관리
</div>

<CardGroup cols={2}>
  <Card title="예산 설정" icon="wallet">
    개발자 콘솔에서 지출 한도를 설정하세요.
  </Card>

  <Card title="알림 모니터링" icon="bell">
    예산 한도에 도달하기 전에 알림을 받도록 설정하세요.
  </Card>

  <Card title="캐싱 사용" icon="database">
    동일한 포스트를 다시 가져오지 않도록 응답을 캐시하세요.
  </Card>

  <Card title="쿼리 최적화" icon="filter">
    정확한 필터를 사용해 필요한 포스트만 조회하세요.
  </Card>
</CardGroup>

***

<div id="pricing-details">
  ## 가격 세부 정보
</div>

엔드포인트와 오퍼레이션별 최신 요금은 [개발자 콘솔](https://console.x.com)에서 확인할 수 있습니다.

가격은 다음 기준에 따라 달라질 수 있습니다.

* 엔드포인트 type (검색 vs. 조회 vs. 스트림)
* 오퍼레이션 (읽기 vs. 쓰기)
* 데이터 범위 (최근 vs. 전체 아카이브)

***

<div id="enterprise-options">
  ## 엔터프라이즈 옵션
</div>

대량 사용이 필요하며 가격을 개별 협의하고 싶은 경우:

* 전담 지원
* 대량 사용 할인
* 맞춤형 요청 한도
* 전체 데이터 액세스 권한

<CardGroup cols={1}>
  <Card title="엔터프라이즈 영업팀에 문의" icon="building" href="/ko/enterprise/forms/enterprise-api-interest">
    요구 사항에 맞춘 맞춤형 솔루션에 대해 상담해 보세요.
  </Card>
</CardGroup>

***

<div id="faqs">
  ## 자주 묻는 질문(FAQ)
</div>

<Accordion title="크레딧이 모두 소진되면 어떻게 되나요?">
  더 많은 크레딧을 구매할 때까지 API 요청이 모두 실패합니다. 중단을 피하려면 잔액 알림을 설정하세요.
</Accordion>

<Accordion title="월 최소 사용량이 있나요?">
  없습니다. 사용한 만큼만 결제하면 됩니다. 사용량과 비용이 0인 달이 있어도 됩니다.
</Accordion>

<Accordion title="스트리밍 사용량은 어떻게 과금되나요?">
  필터링된 스트림을 통해 전달되는 각 고유 게시물은 일일 중복 제거 기준에 따라 사용량으로 계산됩니다.
</Accordion>

<Accordion title="실패한 요청도 과금되나요?">
  아니요. 데이터를 반환하는 성공적인 응답만 과금됩니다.
</Accordion>

***

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

<CardGroup cols={2}>
  <Card title="개발자 콘솔" icon="grid-2" href="https://console.x.com">
    요금제를 확인하고 크레딧을 구매하세요.
  </Card>

  <Card title="요청 한도" icon="gauge-high" href="/ko/x-api/fundamentals/rate-limits">
    청구와는 별도로 적용되는 요청 한도를 이해하세요.
  </Card>
</CardGroup>