> ## 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 では **従量課金** モデルを採用しています。課金は、App 単位で追跡される実際の API 利用量に基づいて行われます。

***

<div id="how-billing-works">
  ## 課金の仕組み
</div>

| 概念             | 説明                             |
| :------------- | :----------------------------- |
| **クレジット制**     | 事前にクレジットを購入し、API を使うごとに差し引かれます |
| **リクエスト単位の料金** | エンドポイントごとに料金が異なります             |
| **リアルタイム追跡**   | 開発者コンソールで利用状況をリアルタイムに確認できます    |
| **上限なし**       | 必要なだけ利用可能で、月間の利用上限はありません       |

***

<div id="tracked-endpoints">
  ## 追跡対象のエンドポイント
</div>

これらのエンドポイントから取得された投稿は、利用量にカウントされます。

| カテゴリ          | エンドポイント                                                                                                                    |
| :------------ | :------------------------------------------------------------------------------------------------------------------------- |
| **ポストルックアップ** | [GET /2/tweets](/ja/x-api/posts/lookup/introduction)                                                                       |
| **検索**        | [最近の検索](/ja/x-api/posts/search/introduction), [全アーカイブ検索](/ja/x-api/posts/search/introduction)                              |
| **ストリーミング**   | [フィルタ済みストリーム](/ja/x-api/posts/filtered-stream/introduction), [フィルタ済みストリーム Webhook](/ja/x-api/webhooks/stream/introduction) |
| **タイムライン**    | [ユーザー投稿](/ja/x-api/posts/timelines/introduction), [ユーザーへのメンション](/ja/x-api/posts/timelines/introduction)                    |
| **エンゲージメント**  | [いいねした投稿](/ja/x-api/posts/likes/introduction), [ブックマーク](/ja/x-api/posts/bookmarks/introduction)                            |
| **リスト**       | [リストの投稿](/ja/x-api/lists/list-tweets/introduction)                                                                         |
| **Spaces**    | [Spaces ルックアップ](/ja/x-api/spaces/lookup/introduction)                                                                      |

***

<div id="deduplication">
  ## 重複排除
</div>

<Note>
  **日次の重複排除**: 同じポストが1日のうちに複数のクエリから返された場合でも、請求上は1回分としてのみカウントされます。
</Note>

これは次のことを意味します。

* 同じポストを1日のうちに複数回取得する = 課金は1回分
* 翌日に同じポストを再取得する = 課金がさらに1回分発生
* 同じリクエスト内に含まれる異なるポスト = それぞれ個別にカウント

***

<div id="monitoring-usage">
  ## 利用状況の監視
</div>

[開発者コンソール](https://console.x.com)で利用状況を確認できます。

| 指標                 | 説明              |
| :----------------- | :-------------- |
| **Total usage**    | 請求期間中に取得された投稿数  |
| **By endpoint**    | エンドポイント種別ごとの内訳  |
| **By app**         | 開発者 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 (search / lookup / stream など)
* 操作 (read / write)
* データの範囲 (recent / full-archive)

***

<div id="enterprise-options">
  ## エンタープライズ向けオプション
</div>

大規模な利用ニーズがあり、カスタム料金を希望される場合:

* 専任サポート
* ボリュームディスカウント
* カスタムのレート制限
* データへの完全アクセス

<CardGroup cols={1}>
  <Card title="エンタープライズセールスへのお問い合わせ" icon="building" href="/ja/enterprise/forms/enterprise-api-interest">
    ニーズに合わせたカスタムソリューションについてご相談ください。
  </Card>
</CardGroup>

***

<div id="faqs">
  ## よくある質問
</div>

<Accordion title="クレジットを使い切るとどうなりますか？">
  クレジットを追加購入するまで、API リクエストはエラーになります。中断を避けるために残高アラートを設定してください。
</Accordion>

<Accordion title="月額の最低利用料はありますか？">
  いいえ、ありません。使用した分だけお支払いいただきます。利用量も費用もゼロの月があってもかまいません。
</Accordion>

<Accordion title="ストリーミングはどのように課金されますか？">
  filtered stream を通じて配信された一意のポストごとに利用分としてカウントされ、日次で重複排除が行われます。
</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="/ja/x-api/fundamentals/rate-limits">
    請求とは別に設定されているリクエスト上限について理解する。
  </Card>
</CardGroup>