메인 콘텐츠로 건너뛰기
X API는 사용량 기반 과금 방식을 사용합니다. 구독도 없고, 월별 한도도 없으며, 사용한 만큼만 지불하면 됩니다.

동작 방식

크레딧 기반

개발자 콘솔에서 크레딧을 미리 구매합니다. API 요청을 보낼 때마다 크레딧이 차감됩니다.

엔드포인트별 요금

엔드포인트마다 비용이 다릅니다. 현재 요금은 개발자 콘솔에서 확인할 수 있습니다.

약정 없음

계약, 구독, 최소 사용 금액 조건이 없습니다. 언제든지 시작하고 중단할 수 있습니다.

실시간 추적

개발자 콘솔에서 사용량과 비용을 실시간으로 모니터링할 수 있습니다.

중복 제거

모든 리소스는 24시간 UTC 일 단위 내에서 중복 제거됩니다. 어떤 리소스(예: 게시물)를 요청해 요금이 청구된 경우, 그 기간 안에 동일한 리소스를 다시 요청하더라도 추가 요금이 부과되지 않습니다. 이는 다음을 의미합니다:
  • 같은 게시물을 하루에 여러 번 요청해도 한 번만 청구됩니다
  • 중복 제거 기준 시간은 UTC 자정에 초기화됩니다
  • 이는 모든 과금 대상 리소스(포스트, 사용자 등)에 적용됩니다
중복 제거는 **소프트 보장(soft guarantee)**입니다. 대부분의 경우 적용되지만, 서비스 장애와 같은 특정 엣지 케이스에서는 리소스가 중복 제거되지 않을 수 있습니다.

크레딧 잔액

크레딧 잔액은 개발자 콘솔에 표시됩니다. API 요청을 보내면 크레딧이 실시간으로 차감됩니다.
서비스 중단을 방지하려면 크레딧 잔액을 정기적으로 확인하세요. API 액세스가 중단되지 않도록 잔액이 0이 되기 전에 크레딧을 충전하세요.참고: 계정 크레딧 잔액이 소폭 음수가 될 수 있습니다. 이 경우, 음수 잔액을 해소할 만큼 크레딧을 추가하기 전까지 API 요청이 차단됩니다.

자동 충전

자동 충전을 활성화하면 크레딧 잔액이 자동으로 충전되어 서비스 중단을 방지할 수 있습니다. 개발자 콘솔에서 다음을 설정하세요:
SettingDescription
Recharge amount자동 충전이 실행될 때 추가되는 금액 (예: $25)
Trigger threshold잔액이 이 금액 아래로 떨어지면 자동 충전이 활성화됩니다 (예: $5)
자동 충전을 사용하려면 기본값으로 지정된 결제 수단이 저장되어 있어야 합니다. 언제든지 개발자 콘솔에서 또는 지원팀에 문의하여 취소할 수 있습니다.

지출 한도

청구 주기마다 사용할 수 있는 최대 금액을 설정해 비용을 관리할 수 있습니다. 한도에 도달하면 다음 청구 주기까지 API 요청이 차단됩니다.
OptionDescription
Spending limit청구 주기마다 최대 지출 금액으로 사용할 구체적인 달러 금액을 설정합니다
특히 개발 및 테스트 중 예기치 않은 요금이 발생하지 않도록 지출 한도를 설정해 두세요.

사용량 모니터링

Usage endpoint를 사용해서 프로그램을 통해 API 사용량을 추적하세요.
curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"
이는 일별 게시물 사용량 건수를 반환하여, 다음과 같은 작업에 도움이 됩니다:
  • 예산 대비 사용량 추적
  • 한도에 가까워질 때 알림 설정
  • 사용량이 많은 엔드포인트 식별
  • 사용량 보고서 생성

엔터프라이즈 요금제

대량 사용을 위한 액세스, 전용 지원, 맞춤형 요청 한도 및 추가 기능이 필요하다면 엔터프라이즈 영업팀에 문의하세요.

다음 단계

개발자 콘솔

크레딧을 구매하고 최신 요금 정보를 확인하세요.

Usage API

사용량을 프로그래밍 방식으로 모니터링하세요.