사용량

API 사용량과 게시물 사용량을 모니터링하고 추적하세요

Usage 엔드포인트는 소비된 포스트 수를 포함한 API 사용량을 모니터링할 수 있게 해줍니다. 사용량을 프로그램적으로 추적하여 비용을 관리하고 한도 내에서 사용량을 유지하세요.

​

개요

포스트 사용량

소비된 포스트를 추적

일별 분석

일별 사용량을 확인

App 단위

App 전체 사용량을 모니터링

---

​

엔드포인트

메서드	엔드포인트	설명
GET	/2/usage/tweets	게시물 사용량 데이터를 조회합니다

---

​

응답 데이터

응답에는 게시물의 일별 소비 건수가 포함됩니다:

{
  "data": {
    "daily_project_usage": [
      {
        "date": "2024-01-15",
        "usage": [
          {
            "app_id": "12345678",
            "tweets_consumed": 15420
          }
        ]
      }
    ],
    "project_id": "1234567890",
    "project_cap": 10000000
  }
}

​

필드

Field	Description
daily_project_usage	일별 사용량 데이터의 배열
date	YYYY-MM-DD 형식의 날짜
app_id	사용 중인 App의 ID
tweets_consumed	해당 일자에 소모된 포스트 수
project_cap	월간 포스트 사용 한도

---

​

요청 예시

curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

사용 사례

• 비용 모니터링 — 요금제 한도 대비 사용량 추적
• 알림 설정 — 한도에 가까워질 때 알림 설정
• 최적화 — 사용량이 많은 엔드포인트 파악
• 보고 — 사용량 보고서 생성

리소스는 24시간(UTC 기준) 기간 내에서 중복 제거되므로, 같은 리소스를 하루에 여러 번 요청해도 하루에 한 번만 과금됩니다. 요금에 대해 더 알아보기 →

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 프로젝트 및 App
• App의 Bearer 토큰

API 참조 문서

전체 엔드포인트에 대한 문서

개발자 콘솔

대시보드에서 사용량 보기