メインコンテンツへスキップ
このガイドでは、2006年3月まで遡るポスト数の履歴を取得する方法を説明します。
フルアーカイブのポスト数を取得するには、Self-serve または Enterprise へのアクセスが必要です。
前提条件始める前に、以下を用意してください。
  • Self-serve または Enterprise にアクセス可能な開発者アカウント
  • ご利用の App のベアラートークン

​
全アーカイブの投稿数を取得する

1

クエリを作成する

全アーカイブ検索と同じクエリ構文を使用します。たとえば、@XDevelopers からの投稿数を取得するには次のようにします:
from:XDevelopers
2

時間範囲を設定する

特定の過去期間を検索するために start_time と end_time を指定します:
パラメータ形式例
start_timeISO 86012020-01-01T00:00:00Z
end_timeISO 86012020-12-31T23:59:59Z
3

リクエストを送信する

cURL
curl "https://api.x.com/2/tweets/counts/all?\
query=from%3AXDevelopers&\
start_time=2020-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
granularity=day" \
  -H "Authorization: Bearer $BEARER_TOKEN"
4

レスポンスを確認する

{
  "data": [
    {
      "end": "2020-01-02T00:00:00.000Z",
      "start": "2020-01-01T00:00:00.000Z",
      "tweet_count": 3
    },
    {
      "end": "2020-01-03T00:00:00.000Z",
      "start": "2020-01-02T00:00:00.000Z",
      "tweet_count": 5
    }
  ],
  "meta": {
    "total_tweet_count": 8
  }
}

​
粒度オプション

カウントの集計単位を制御します。
粒度説明
minute分ごとのカウント
hour時間ごとのカウント (デフォルト)
day日ごとのカウント

​
ページネーションで結果を取得する

期間が長い場合は、レスポンスに含まれる next_token を使用します。
cURL
curl "https://api.x.com/2/tweets/counts/all?\
query=from%3AXDevelopers&\
start_time=2015-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
granularity=day&\
next_token=abc123" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
最近の件数との主な違い

機能Recent CountsFull-Archive Counts
時間範囲直近7日間2006年3月から現在まで
必要なアクセスレベルすべての開発者従量課金、エンタープライズ
デフォルトの時間範囲直近7日間直近30日間

​
共通パラメーター

パラメーター説明デフォルト
query検索クエリ (必須)—
granularity時間バケットの粒度hour
start_time最も古いタイムスタンプ (ISO 8601)30日前
end_time最も新しいタイムスタンプ (ISO 8601)現在
next_tokenページネーション用トークン—

​
次のステップ

最近の件数

直近の投稿数を取得する

クエリを構築する

クエリ構文を使いこなす

APIリファレンス

エンドポイントの完全なドキュメント