使用状況

API の使用状況を監視し、ポストの利用量を追跡します

Usage エンドポイントでは、消費した投稿数を含む API の利用状況を監視できます。利用状況をプログラムから追跡して、コストを管理し、利用上限内に収まるようにできます。

​

概要

投稿の利用状況

消費された投稿数を追跡します

日別の内訳

日ごとの利用状況を表示します

App レベル

App 全体の利用状況を監視します

---

​

エンドポイント

Method	Endpoint	Description
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	1日ごとの利用データの配列
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) の時間枠内で重複排除されるため、同じリソースを同じ日に複数回リクエストしても、課金上は1回分としてのみカウントされます。 料金について詳しく見る →

---

​

はじめに

前提条件

• 承認済みの開発者アカウント
• 開発者コンソール内の Project と App
• App の ベアラートークン

APIリファレンス

エンドポイントに関する詳細ドキュメント

開発者コンソール

ダッシュボードで使用状況を確認できます