> ## 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.
# Post Counts
> Post counts エンドポイントは、クエリに一致する投稿の時間経過に伴うボリュームを、投稿本文を返さずに提供します。counts を扱う X API v2 スタンダードティアのリファレンス。
export const Button = ({href, children}) => {
return ;
};
Post counts エンドポイントは、クエリに一致する投稿の時間経過に伴うボリュームを、投稿本文を返さずに提供します。これらのエンドポイントを使用して、トレンドを分析したり、会話規模を把握したり、検索を実行する前にクエリを洗練したりできます。
## 概要
投稿ボリュームの時間推移を示すトレンドラインや可視化を構築
完全な検索クエリを実行する前に結果サイズを見積もる
イベント周辺で会話がピークに達した時点を特定
全投稿を取得せずに会話規模を把握
***
## エンドポイント
| Endpoint | Description | Access |
| :---------------------------------------------------------------------- | :-------------- | :-------------- |
| GET [`/2/tweets/counts/recent`](/x-api/posts/get-count-of-recent-posts) | 直近 7 日間の投稿数を集計 | すべての開発者 |
| GET [`/2/tweets/counts/all`](/x-api/posts/get-count-of-all-posts) | 完全アーカイブから投稿数を集計 | 従量課金、Enterprise |
***
## Granularity オプション
`granularity` パラメーターで集計単位を指定します:
| Granularity | Description | Use case |
| :---------- | :----------------- | :----------- |
| `minute` | 1 分ごとのカウント | リアルタイムモニタリング |
| `hour` | 1 時間ごとのカウント(デフォルト) | 日次分析 |
| `day` | 1 日ごとのカウント | 長期トレンド |
***
## Recent counts
**直近 7 日間**の投稿数をカウントします。すべての開発者が利用可能です。
### 特徴
* 分・時間・日単位でグループ化されたカウント
* Recent search と同じクエリ演算子
* 512 文字までのクエリ長
### レスポンス例
```json theme={null}
{
"data": [
{ "start": "2024-01-15T00:00:00.000Z", "end": "2024-01-15T01:00:00.000Z", "tweet_count": 1523 },
{ "start": "2024-01-15T01:00:00.000Z", "end": "2024-01-15T02:00:00.000Z", "tweet_count": 1247 },
{ "start": "2024-01-15T02:00:00.000Z", "end": "2024-01-15T03:00:00.000Z", "tweet_count": 892 }
],
"meta": {
"total_tweet_count": 3662
}
}
```
最初の recent counts リクエストを行う
エンドポイントの完全なドキュメント
***
## Full-archive counts
2006 年までさかのぼる**完全アーカイブ**から投稿数を集計します。
Full-archive counts は従量課金と Enterprise のお客様が利用できます。
### 特徴
* 任意の期間の履歴投稿数を集計
* すべてのクエリ演算子が利用可能
* 1,024 文字までのクエリ長(Enterprise は 4,096 文字)
### ページネーション
レスポンスあたり 31 日でページ分割されます:
* **Day granularity**: 1 ページあたり 31 日
* **Hour granularity**: 1 ページあたり 744 時間 (31 日)
* **Minute granularity**: 1 ページあたり 44,640 分 (31 日)
最初の full-archive counts リクエストを行う
エンドポイントの完全なドキュメント
***
## クエリ演算子
Post counts は search エンドポイントと同じクエリ構文を使用します:
```
python lang:en -is:retweet
```
クエリ構文と演算子を学ぶ
***
## 重要事項
**Counts と検索結果**
Counts は検索結果と完全に一致しない場合があります。検索エンドポイントは、counts エンドポイントでは行われない追加のコンプライアンスフィルタリングを適用します。
***
## はじめる
**前提条件**
* 承認済みの[開発者アカウント](https://developer.x.com/en/portal/petition/essential/basic-info)
* 開発者コンソール内の [Project と App](/resources/fundamentals/developer-apps)
* App の [Bearer Token](/resources/fundamentals/authentication)
直近 7 日間の投稿数を集計
履歴投稿数を集計
主要な概念とベストプラクティス
動作するコード例