概要

X API のポスト件数エンドポイントの比較

v2 ポスト件数エンドポイントは、最終的には enterprise Search API の counts エンドポイント を置き換える予定です。既存のコードや App、ツールで旧バージョンのポスト件数エンドポイントを利用していて、新しい X API v2 エンドポイントへの移行を検討している場合は、このガイドがお役に立ちます。

---

直近の投稿数の比較

Enterprise 版の投稿数エンドポイントでは、過去 30 日間分または全アーカイブから投稿数を取得できます。そのため、7 日間を対象とする v2 の recent 投稿数エンドポイントは、前述のいずれのエンドポイントの直接の代替にはなりません。

ただし比較しやすくするために、ここでは v2 の recent 投稿数エンドポイントが Enterprise の 30 日エンドポイントとどのように異なるかを確認します。

次の表は、各種 recent 投稿数エンドポイントを比較したものです。

説明	Enterprise	X API v2
ホストドメイン	https://gnip-api.x.com	https://api.x.com
エンドポイントパス	/search/30day/accounts/:account_name/:label/counts.json	/2/tweets/counts/recent
認証	Basic 認証	OAuth 2.0 ベアラートークン
タイムスタンプ形式	YYYYMMDDhhmm	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
カウント対象となる投稿の最大経過期間	31 日	7 日
戻されるのはどの程度古くない投稿のカウントか	31 days	7 days
対応している HTTP メソッド	GET	GET
デフォルトのレート制限	検索データおよびカウントリクエストの合計で 1 秒あたり 20 リクエスト 1 分あたりのレート制限は、契約書に記載されたパートナーごとの値により異なります。	ユーザーごとに 15 分あたり 180 リクエスト App ごとに 15 分あたり 450 リクエスト
annotations を使ったフィルタリングのサポート		✔
conversation_id を使ったフィルタリングのサポート		✔
投稿データ配列の JSON キー名	results	data
時間の粒度	日、時間、または分	日、時間、または分
タイムゾーン	UTC	UTC
取得期間を指定するためのリクエストパラメータ	fromDate toDate	start_time end_time
投稿 ID によるナビゲーションのためのリクエストパラメータ		since_id until_id
project に関連付けられた developer App の認証情報の使用が必要		✔

フルアーカイブのポスト数の比較

次の表は、さまざまなフルアーカイブ検索エンドポイントを比較したものです。

説明	Enterprise	X API v2
ホストドメイン	https://gnip-api.x.com	https://api.x.com
エンドポイントパス	/search/fullarchive/accounts/:account_name/:label/counts	/2/tweets/counts/all
認証	Basic 認証	OAuth 2.0 ベアラートークン
タイムスタンプ形式	YYYYMMDDHHMM	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
返されるポスト数の対象となる最も古い期間	2006年3月以降のフルアーカイブ	2006年3月以降のフルアーカイブ
対応するHTTPメソッド	GET POST	GET
デフォルトのリクエストレート制限	1分あたりのレート制限は、契約で指定されたとおりパートナーごとに異なります。 1秒あたり20リクエスト	Appごとに15分あたり300リクエスト Appごとに1秒あたり1リクエスト
粒度	日、時、分	日、時、分
annotations を使用したフィルタリングのサポート		✔
conversation_id を使用したフィルタリングのサポート		✔
ポストデータ配列のJSONキー名	results	data
期間を指定するためのリクエストパラメータ	fromDate toDate	start_time end_time
ポストIDによるナビゲーション用リクエストパラメータ		since_id until_id
ページネーション用JSONキー名	next	meta.next_token
ページネーション用リクエストパラメータ	next_token	next_token または pagination_token
タイムゾーン	UTC	UTC
Academic Research access を持つ Project に関連付けられた developer App の認証情報の使用が必要		✔

フィルタリングオペレーターの比較

2つの異なるバージョン (Enterprise と v2) のポスト数エンドポイントでは、利用可能なオペレーターの種類が異なり、さらに各バージョン内でもオペレーターの提供レベルが異なります。これについて以下で説明します。

Enterprise

• Enterprise オペレーターにサブティアはありません。すべての Enterprise オペレーターは、すべての Enterprise ユーザーが利用できます。

X API v2

• Core: これらのオペレーターは、すべての v2 ユーザーが利用できます。
• Advanced: これらのオペレーターは、Academic Research アクセスが承認されたユーザーのみが利用できます。

それぞれのオペレーター群の詳細は、対応するガイドで確認できます。

• Enterprise オペレーター
• X API v2 オペレーター

X API v2 におけるこれらの異なるオペレーターのレベルを把握したところで、ポスト数エンドポイントにおけるオペレーターの利用可否を示した表を以下に示します (セルが空欄の場合、そのオペレーターは利用できません) 。

	Enterprise	v2
keyword	利用可能	Core
emoji	利用可能	Core
“exact phrase”	利用可能	Core
#	利用可能	Core
$	利用可能	Advanced
@	利用可能	Core
from:	利用可能	Core
to:	利用可能	Core
url:	利用可能	Core
retweets_of:	利用可能	Core
context:		Core
entity:		Core - recent search でのみ利用可能
conversation_id:		Core
place:	利用可能	Advanced
place_country:	利用可能	Advanced
point_radius:	利用可能	Advanced
bounding_box:	利用可能	Advanced
is:retweet	利用可能	Core
is:reply	利用可能	Core
is:quote	利用可能	Core
is:verified	利用可能	Core
-is:nullcast	利用可能	Advanced
has:hashtags	利用可能	Core
has:cashtags	利用可能	Advanced
has:links	利用可能	Core
has:mentions	利用可能	Core
has:media	利用可能	Core
has:images	利用可能	Core
has:videos	利用可能	Core
has:geo	利用可能	Advanced
lang:	利用可能	Core
list:		Advanced
has:profile_geo	利用可能
profile_country	利用可能
profile_locality	利用可能
profile_region	利用可能
proximity	利用可能

その他の移行リソース

X API 移行ハブ

これらのエンドポイントのサンプルコードを確認する

ポスト数: Enterprise から X API v2 への移行