Skip to main content

​
X API の検索Postエンドポイントの比較

v2 の Search Tweets エンドポイントは、最終的に standard v1.1 search/posts エンドポイントおよび enterprise Search API を置き換える予定です。旧バージョンの X の検索エンドポイントを使用しているコード、アプリ、またはツールがあり、X API v2 の新しいエンドポイントへの移行を検討している場合は、このガイドをご覧ください。 このページには次の3つの比較表が含まれます:

​
直近検索の比較

次の表は、直近検索エンドポイントの各種タイプを比較したものです。
説明Standard v1.1X API v2
ホストドメインhttps://api.x.comhttps://api.x.com
エンドポイントパス/1.1/search/tweets.json/2/tweets/search/recent
認証OAuth 1.0a ユーザーコンテキスト
OAuth 2.0 App-Only		OAuth 1.0a ユーザーコンテキスト

OAuth 2.0 認可コード（PKCE 対応）

OAuth 2.0 App-Only
タイムスタンプ形式YYYYMMDDYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返される Post の最長経過期間7 days7 days
対応 HTTP メソッドGETGET
既定のリクエストレート制限OAuth 1.0a ユーザーコンテキストで 15 分あたり 180 リクエスト

OAuth 2.0 App-Only で 15 分あたり 450 リクエスト		ベーシック：

OAuth 2.0 App-Only で 15 分あたり 60 リクエスト

OAuth 1.0a ユーザーコンテキストで 15 分あたり 60 リクエスト

OAuth 2.0 認可コード（PKCE 対応）で 15 分あたり 60 リクエスト

プロ：

OAuth 2.0 App-Only で 15 分あたり 450 リクエスト

OAuth 1.0a ユーザーコンテキストで 15 分あたり 180 リクエスト

OAuth 2.0 認可コード（PKCE 対応）で 15 分あたり 180 リクエスト
完全展開された URL を提供✔
レスポンスあたりの最大 Post 数（既定）100 (15)100 (10)
Post の JSON 形式Standard v1.1 形式X API v2 形式（fields と expansions のリクエストパラメータで決定。v1.1 形式との後方互換性なし）

Standard v1.1 形式から X API v2 形式への移行については、データ形式移行ガイドをご覧ください。
ペイロードで返す fields の選択をサポート✔
annotations の要求と受信をサポート✔
Post オブジェクト内の特定の metrics の要求をサポート✔
conversation_id オペレーターおよびフィールドをサポート✔
Post の編集履歴を提供✔✔
Post のデータ配列の JSON キー名statusesdata
ページネーションの JSON キー名search_metadata.next_resultsmeta.next_token
時間範囲でのアーカイブのナビゲーションをサポート✔✔
時間ベースのリクエストの時間解像度daysecond
タイムゾーンUTCUTC
時間でナビゲートするためのリクエストパラメータuntilstart_time
end_time
Post ID でナビゲートするためのリクエストパラメータsince_id 
max_id		since_id 
until_id
ページネーション用のリクエストパラメータURL エンコード済みクエリを提供next_token
プロジェクト に関連付けられた 開発者アプリ の認証情報の使用が必要✔

​
全アーカイブ検索の比較

次の表は、各種の全アーカイブ検索エンドポイントの比較です。
説明エンタープライズX API v2
ホストドメインhttps://gnip-api.x.comhttps://api.x.com
エンドポイントパス/search/fullarchive/accounts/:account_name/:label/2/tweets/search/all
認証Basic authOAuth 2.0 App-Only
タイムスタンプ形式YYYYMMDDHHMMYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返されるPostの最古の時期2006年3月以降の全アーカイブ2006年3月以降の全アーカイブ
対応HTTPメソッドGET
POST		GET
既定のリクエストレート制限1分あたりのレート制限は、契約に従いパートナーごとに異なります。

Basic auth で毎秒20リクエスト		OAuth 2.0 App-Only で15分あたり300リクエスト

OAuth 2.0 App-Only で1秒あたり1リクエスト
展開済みURLの提供✔✔
レスポンスあたりのPost数最大: 500
既定: 100		最大: 500
既定: 10
PostのJSON形式Native Enriched または Activity Streams 形式X API v2 形式（fields および expansions のリクエストパラメータにより決定）
ペイロードで返す fields の選択に対応✔
annotations のリクエストと受信に対応✔
Postオブジェクト内の特定のmetrics のリクエストに対応✔
conversation_id 演算子とフィールドに対応✔
Postの編集履歴を提供✔✔
Postのdata配列のJSONキー名resultsdata
ページネーションのJSONキー名nextmeta.next_token
時間ベースのリクエストの時間解像度secondsecond
タイムゾーンUTCUTC
Post IDによるアーカイブのナビゲーションに対応✔
時間によるナビゲーションのリクエストパラメータfromDate
toDate		start_time
end_time
Post IDによるナビゲーションのリクエストパラメータsince_id
until_id
ページネーションのリクエストパラメータnext_tokennext_token
Academic Research アクセスを有する Project に関連付けられた developer App の認証情報の使用が必要✔
フィルタリング演算子の比較 検索Postの各バージョン（standard、enterprise、v2）では、利用可能な演算子が異なり、同一バージョン内でも演算子の提供レベルに差があります。以下で説明します。 Enterprise
  • enterprise 演算子にサブ階層はありません
X API v2
  • 無料: 任意のProjectで利用可能
  • ベーシック: 任意のProjectで利用可能
  • プロ: Projectで利用可能
  • エンタープライズ: Projectで利用可能
これらの演算子セットについては、それぞれのガイドで詳しく確認できます。 X API v2 における演算子レベルを理解したうえで、検索Postにおける演算子の提供状況を示す表は次のとおりです（セルが空白の場合、その演算子は利用できません）。
検索オペレーターStandardEnterprisev2
keyword利用可能
q:keyword		利用可能ベーシック & プロ
emoji利用可能
q:😄		利用可能ベーシック & プロ
“exact phrase”利用可能利用可能ベーシック & プロ
#利用可能利用可能ベーシック & プロ
$利用可能利用可能プロ
@利用可能利用可能ベーシック & プロ
from:利用可能利用可能ベーシック & プロ
to:利用可能利用可能ベーシック & プロ
url:利用可能利用可能ベーシック & プロ
retweets_of:利用可能ベーシック & プロ
context:ベーシック & プロ
entity:ベーシック & プロ - 直近検索でのみ利用可能
conversation_id:ベーシック
place:利用可能プロ
place_country:利用可能プロ
point_radius:geocode パラメータ利用可能プロ
bounding_box:利用可能プロ
is:retweetfilter:retweets利用可能ベーシック & プロ
is:reply利用可能ベーシック & プロ
is:quote利用可能ベーシック & プロ
is:verified利用可能ベーシック & プロ
-is:nullcast利用可能プロ
has:hashtags利用可能ベーシック & プロ
has:cashtags利用可能プロ
has:linksfilter:links利用可能ベーシック & プロ
has:mentions利用可能ベーシック & プロ
has:mediafilter:media利用可能ベーシック & プロ
has:imagesfilter:images, filter:twimg利用可能ベーシック & プロ
has:videosfilter:videos
filter:native_video		利用可能ベーシック & プロ
has:geo利用可能プロ
lang:lang - オペレーターまたはパラメータとして使用可能利用可能ベーシック & プロ
has:profile_geo利用可能
profile_country利用可能
profile_locality利用可能
profile_region利用可能
proximity利用可能
:(利用可能
:)利用可能
?利用可能
filter:periscope利用可能
list:利用可能プロ
filter:replies利用可能
filter:pro_video利用可能
filter:social利用可能
filter:trusted利用可能
filter:follows利用可能
filter:has_engagement利用可能
include:antisocial利用可能
include:offensive_user利用可能
include:antisocial_offensive_user利用可能
include:sensitive_content利用可能
source:利用可能
min_replies:利用可能
min_retweets:利用可能
min_faves:利用可能
card_name:利用可能
card_domain:利用可能
その他の移行リソース X API 移行ハブ これらのエンドポイントのサンプルコードを見る Search Posts: Standard v1.1 から X API v2 への移行 Search Posts: Enterprise から X API v2 への移行