v1 から v2 へ（Enterprise）

Enterprise と X API v2 の比較

共通点

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

相違点

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

類似点

粒度

返されるデータの粒度を選択するためのパラメータは、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 を使用します。

違い

エンドポイント 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 と、それに関連付けられた Project の認証情報を使用する必要があります。X API v1.1 のすべてのエンドポイントでは、App からの認証情報、または別の App に関連付けられた App からの認証情報を使用できます。  

利用可能な期間

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

しかし、X API v2 には Enterprise API のような 30 日間の期間エンドポイントはありません。その代わり、前述の全アーカイブ、または v2 Search Posts エンドポイント と整合する 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 移行ランディングページを参照してください。

APIリファレンス インデックス

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

最近の投稿数

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

全アーカイブの投稿数

セルフサービスおよびエンタープライズのアクセス権をお持ちの方のみ利用できます

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