Skip to main content

​
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 のリクエストパラメータの比較表です。
EnterpriseSearch Posts v2
queryquery
bucketgranularity
fromDate (YYMMDDHHmm)start_time (YYYY-MM-DDTHH:mm:ssZ)
toDate (YYMMDDHHmm)end_time (YYYY-MM-DDTHH:mm:ssZ)
since_id
until_id
nextnext_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)