メインコンテンツへスキップ
Post カウントエンドポイントは、クエリにマッチする投稿の件数を、投稿自体を返さずに時間の経過に沿った推移として返します。これらのエンドポイントを使用して、トレンドを分析し、会話の規模を把握し、検索を実行する前にクエリを調整してください。

​
概要

ボリューム分析

時系列で投稿数のトレンドラインや可視化を作成します

クエリの絞り込み

完全な検索クエリを実行する前に結果件数を見積もります

イベント検出

イベントに関連する会話がピークに達したタイミングを特定します

効率的な調査

すべての投稿を取得せずに会話規模を把握します

​
エンドポイント

Endpoint説明アクセス
GET /2/tweets/counts/recent直近7日間の投稿数を取得すべての開発者
GET /2/tweets/counts/all全アーカイブの投稿数を取得従量課金制、Enterprise

​
粒度オプション

granularity パラメータを使用して、カウントの集計単位を指定します。
Granularity説明ユースケース
minute1分ごとのカウントリアルタイム監視
hour1時間ごとのカウント (デフォルト)日次分析
day1日ごとのカウント長期トレンド分析

​
直近の件数

直近7日間の投稿数を集計します。すべての開発者が利用できます。

​
機能

  • 分単位、時間単位、日単位での件数集計
  • Recent search と同じクエリ演算子
  • クエリ長は最大 512 文字

​
レスポンス例

{
  "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 リクエストを送信する

APIリファレンス

エンドポイントの詳細ドキュメント

​
フルアーカイブカウント

2006年までさかのぼり、アーカイブ全体から投稿数をカウントします。
フルアーカイブカウントは、従量課金制プランと Enterprise のお客様が利用可能です。

​
機能

  • 任意の期間の過去のポスト数をカウント
  • すべてのクエリ演算子が利用可能
  • クエリ長は 1,024 文字 (Enterprise では 4,096 文字)
結果はレスポンスごとに31日分ずつページネーションされます：
  • 日単位の粒度: 1ページあたり31日分
  • 時間単位の粒度: 1ページあたり744時間分 (31日分)
  • 分単位の粒度: 1ページあたり44,640分 (31日分)

クイックスタート

最初のフルアーカイブ件数リクエストを行う

APIリファレンス

エンドポイントの詳細なドキュメント

​
クエリ演算子

ポスト数は検索エンドポイントと同じクエリ構文を使用します。 
python lang:en -is:retweet

クエリを作成する

クエリの構文と演算子を学ぶ

​
重要な注意事項

件数と検索結果の違い件数は検索結果と完全には一致しない場合があります。検索エンドポイントでは、件数エンドポイントでは実行されない追加のコンプライアンス・フィルタリングが適用されます。

​
はじめに

前提条件

最近の件数クイックスタート

直近7日間の投稿数を取得します

全アーカイブクイックスタート

過去の投稿数を取得します

統合ガイド

基本概念とベストプラクティス

サンプルコード

実行可能なコード例