> ## 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.

# v1 から v2 へ（Enterprise）

<div id="enterprise-compared-to-x-api-v2">
  ### Enterprise と X API v2 の比較
</div>

**共通点**

* 粒度
* ページネーション
* タイムゾーン

**相違点**

* エンドポイント URL
* App および Project の要件
* 利用可能な期間
* レスポンスデータの形式
* HTTP メソッド
* リクエストの時刻形式
* リクエストパラメータ
* フィルタリング演算子

<div id="similarities">
  #### 類似点
</div>

**粒度**

返されるデータの粒度を選択するためのパラメータは、enterprise 版では `bucket`、v2 版では `granularity` と異なりますが、そのパラメータに指定できる値とデフォルトの挙動は同じです。

* `day`
* `hour` (default)
* `minute`

**ページネーション**

v2 には追加のページネーション機能 (`since_id` と `until_id` を使ってポスト ID を指定して遷移できる新しいページネーションパラメータ) がありますが、enterprise と v2 のどちらでも、時間を使ってページネーションを行うことができます (enterprise では `fromDate` と `toDate`、v2 では `start_time` と `end_time`) 。

enterprise 版を使用している場合、ページネーションには `next` パラメータを使用し、次のトークン用フィールドは `next` という名前で、レスポンスのルート階層に配置されます。

v2 を使用している場合、ページネーションには `next_token` または `pagination_token` パラメータのどちらかを使用でき、次のトークンはレスポンス内の `meta.next_token` に配置されます。
 

**タイムゾーン**

ページネーションのセクションで述べたように、enterprise と v2 のどちらでも、時間を使って異なるページのデータを取得できます。いずれの場合も、これらのパラメータを使用する際のタイムゾーンには UTC を使用します。

<div id="differences">
  #### 違い
</div>

**エンドポイント URL**

* Enterprise エンドポイント:
  * 30 day - `http://gnip-api.x.com/search/30day/accounts/:account_name/:label/counts.json`
  * Full-archive - `http://gnip-api.x.com/search/fullarchive/accounts/:account_name/:label/counts.json`
* X API v2 エンドポイント
  * Recent (7 day) - `https://api.x.com/2/tweets/counts/recent`
  * Full-archive - `https://api.x.com/2/tweets/counts/all`

**App と Project の要件**

X API v2 のエンドポイントでは、リクエストを認証する際に、[developer App](/ja/resources/fundamentals/developer-apps) と、それに関連付けられた [Project](/ja/resources/fundamentals/developer-apps) の認証情報を使用する必要があります。X API v1.1 のすべてのエンドポイントでは、App からの認証情報、または別の App に関連付けられた App からの認証情報を使用できます。
 

**利用可能な期間**

Enterprise API と X API v2 の両方で、ポストの全アーカイブに対するポストボリュームデータを取得できるエンドポイントを提供しています。

しかし、X API v2 には Enterprise API のような 30 日間の期間エンドポイントはありません。その代わり、前述の全アーカイブ、または [v2 Search Posts エンドポイント](/ja/x-api/posts/search/introduction) と整合する 7 日間の期間を提供します。
 

**レスポンスデータ形式**

Enterprise と X API v2 で受け取るデータ形式には、いくつかの細かな違いがあります。

* Enterprise の counts データは `results` オブジェクト内にありますが、v2 の counts データは `data` オブジェクト内にあります。
* Enterprise の counts フィールドは `timePeriod` (開始時刻) と `count` と呼ばれますが、v2 では期間を `start` フィールドと `end` フィールドに分割し (Enterprise とは異なる日付/時刻形式を使用します。詳細はリクエスト時刻形式を参照) 、`count` フィールドの名前を `tweet_count` に変更しました。
* Enterprise のメタデータには、ルートレベルに `totalCount`、`next`、および `requestParameters` オブジェクトが含まれます。一方、v2 には `requestParameters` オブジェクトは含まれず、代わりに次の項目をルートレベルに存在する `meta` オブジェクト内に移動/改名します: `total_tweet_count` と `next_token`。
   

**HTTP メソッド**

Enterprise バージョンの API では、JSON ボディを持つ POST HTTP メソッド、またはクエリ文字列を持つ GET HTTP メソッドのいずれかでリクエストを送信できます。

v2 では、クエリ文字列を持つ GET HTTP メソッドのみが使用可能です。
 

**リクエスト時刻形式**

このエンドポイントの Enterprise バージョンでは、ページネーションパラメータと `timePeriod` レスポンスフィールドの両方で、次の日時形式を使用します: `YYYYMMDDHHmm`

v2 エンドポイントでは、ページネーションパラメータと `start` および `end` レスポンスフィールドの両方で、ISO 8601/RFC 3339 日時形式を使用します: `YYYY-MM-DDTHH:mm:ssZ`

**リクエストパラメータ**

以下は、Enterprise と X API v2 のリクエストパラメータの比較表です。

| Enterprise            | Search Posts v2                    |
| :-------------------- | :--------------------------------- |
| query                 | query                              |
| bucket                | granularity                        |
| fromDate (YYMMDDHHmm) | start\_time (YYYY-MM-DDTHH:mm:ssZ) |
| toDate (YYMMDDHHmm)   | end\_time (YYYY-MM-DDTHH:mm:ssZ)   |
|                       | since\_id                          |
|                       | until\_id                          |
| next                  | next\_token と pagination\_token    |

**フィルタリングオペレーター**

Enterprise と X API v2 のオペレーターはほとんど同じですが、利用可能なオペレーターにはいくつか違いがあり、X API v2 バージョンにのみ導入された新しいオペレーターもあります。

X API v2、Enterprise、さらに premium で利用可能なオペレーターの完全な一覧表については、[Post counts 移行ランディングページ](/ja/x-api/posts/counts/migrate/overview)を参照してください。

<div id="api-reference-index">
  ## APIリファレンス インデックス
</div>

完全なAPIリファレンスを参照するには、以下のエンドポイントのいずれかを選択してください。

<div id="recent-post-counts">
  ### 最近の投稿数
</div>

|                            |                                                                                                         |
| :------------------------- | :------------------------------------------------------------------------------------------------------ |
| **過去7日間でクエリに一致する投稿数を取得する** | `[GET /2/tweets/counts/recent](/x-api/posts/tweet-counts#api-reference-index/get-tweets-counts-recent)` |

<div id="full-archive-post-counts">
  ### 全アーカイブの投稿数
</div>

[セルフサービスおよびエンタープライズのアクセス権](/ja/x-api/getting-started/about-x-api)をお持ちの方のみ利用できます

|                      |                                                                                                   |
| :------------------- | :------------------------------------------------------------------------------------------------ |
| **クエリに一致する投稿数を取得する** | `[GET /2/tweets/counts/all](/x-api/posts/tweet-counts#api-reference-index/get-tweets-counts-all)` |