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

# 사용량 및 청구

> X API v2는 사용량 기반 결제 방식을 사용합니다. 앱 수준에서 추적되는 실제 API 소비에 따라 청구됩니다. 사용량 기반 요금제에는 월별 한도가 적용됩니다.

X API v2는 **사용량 기반(pay-per-usage)** 요금제를 사용합니다. 앱 수준에서 추적되는 실제 API 소비를 기준으로 청구됩니다.

***

## 청구 작동 방식

| 개념         | 설명                           |
| :--------- | :--------------------------- |
| **크레딧 기반** | 크레딧을 미리 구매하고 API를 사용할 때 차감됨  |
| **요청당 가격** | 서로 다른 endpoint는 서로 다른 비용을 가짐 |
| **실시간 추적** | Developer Console에서 사용량 모니터링 |

<Note>
  사용량 기반 요금제에는 월 200만 Post 읽기 한도가 적용됩니다. 더 큰 볼륨이 필요한 경우 [Enterprise 요금제](/forms/enterprise-api-interest)를 고려하세요.
</Note>

***

## 추적되는 endpoint

이 endpoint에서 조회된 Post는 사용량에 계산됩니다:

| 카테고리        | Endpoint                                                                                                                |
| :---------- | :---------------------------------------------------------------------------------------------------------------------- |
| **Post 조회** | [GET /2/tweets](/x-api/posts/lookup/introduction)                                                                       |
| **검색**      | [Recent search](/x-api/posts/search/introduction), [Full-archive search](/x-api/posts/search/introduction)              |
| **스트리밍**    | [Filtered stream](/x-api/posts/filtered-stream/introduction), [Filtered stream 웹훅](/x-api/webhooks/stream/introduction) |
| **타임라인**    | [User posts](/x-api/posts/timelines/introduction), [User mentions](/x-api/posts/timelines/introduction)                 |
| **참여**      | [Liked posts](/x-api/posts/likes/introduction), [Bookmarks](/x-api/posts/bookmarks/introduction)                        |
| **List**    | [List posts](/x-api/lists/list-tweets/introduction)                                                                     |
| **Space**   | [Spaces lookup](/x-api/spaces/lookup/introduction)                                                                      |

***

## 중복 제거

<Note>
  **일일 중복 제거**: 하루 내에 여러 쿼리에서 동일한 게시물이 반환되는 경우, 청구는 한 번만 계산됩니다.
</Note>

이는 다음을 의미합니다:

* 하루에 같은 게시물을 여러 번 조회 = 1회 청구
* 다음 날 동일한 게시물을 다시 조회 = 1회 추가 청구
* 같은 요청에서 다른 게시물 = 각각 개별 계산

***

## 사용량 모니터링

[Developer Console](https://console.x.com)에서 사용량을 추적하세요:

| 지표            | 설명                 |
| :------------ | :----------------- |
| **총 사용량**     | 청구 기간 동안 조회된 게시물   |
| **Endpoint별** | Endpoint 유형별 세부 분석 |
| **앱별**        | Developer 앱별 사용량   |
| **비용 추적**     | 실시간 비용 계산          |
| **크레딧 잔액**    | 남은 선불 크레딧          |

***

## 비용 관리

<CardGroup cols={2}>
  <Card title="예산 설정" icon="wallet">
    Developer Console에서 지출 한도를 구성하세요.
  </Card>

  <Card title="알림 모니터링" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bell.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=5e0b3dcfbb39ba3d4619931d7cd927d1" width="24" height="24" data-path="icons/xds/icon-bell.svg">
    예산 임계값에 도달하기 전에 알림을 받으세요.
  </Card>

  <Card title="캐싱 사용" icon="database">
    동일한 게시물의 재조회를 방지하도록 응답을 캐시하세요.
  </Card>

  <Card title="쿼리 최적화" icon="https://mintcdn.com/x-preview/szd6PKNMlRQoyyAo/icons/xds/icon-filter.svg?fit=max&auto=format&n=szd6PKNMlRQoyyAo&q=85&s=5d59aff402c1f2aeae0e9e44bb23400e" width="24" height="24" data-path="icons/xds/icon-filter.svg">
    필요한 게시물만 조회하도록 정확한 필터를 사용하세요.
  </Card>
</CardGroup>

***

## 가격 세부 정보

Endpoint 및 작업당 현재 가격은 [Developer Console](https://console.x.com)을 방문하세요.

가격은 다음에 따라 다를 수 있습니다:

* Endpoint 유형(search vs. lookup vs. stream)
* 작업(읽기 vs. 쓰기)
* 데이터 범위(recent vs. full-archive)

***

## Enterprise 옵션

맞춤형 가격이 필요한 대용량 사용 사례:

* 전용 지원
* 볼륨 할인
* 맞춤형 rate limit
* 완전한 데이터 액세스

<CardGroup cols={1}>
  <Card title="Enterprise Sales 문의" icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-bank.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=6dd9ad48fa88936abb112b49e022abff" href="/enterprise/forms/enterprise-api-interest" width="24" height="24" data-path="icons/xds/icon-bank.svg">
    귀사의 요구에 맞는 맞춤 솔루션을 논의하세요.
  </Card>
</CardGroup>

***

## FAQ

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

<Accordion title="월별 최소 금액이 있나요?">
  아니요. 사용한 만큼만 지불합니다. 사용량이 없고 비용도 없는 달을 가질 수 있습니다.
</Accordion>

<Accordion title="스트리밍은 어떻게 청구되나요?">
  Filtered stream을 통해 전달된 각 고유 게시물이 사용량에 계산되며, 일일 중복 제거가 적용됩니다.
</Accordion>

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

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="Developer Console" icon="grid-2" href="https://console.x.com">
    가격을 보고 크레딧을 구매하세요.
  </Card>

  <Card title="Rate limit" icon="gauge-high" href="/x-api/fundamentals/rate-limits">
    요청 한도 이해(청구와 별개).
  </Card>
</CardGroup>