Skip to main content

​
X API の Search Posts エンドポイントの比較

v2 Search Tweets エンドポイントは、最終的に standard v1.1 search/posts エンドポイントおよび enterprise Search API を置き換える予定です。コードや App、ツールで古いバージョンの X の検索エンドポイントを使用していて、新しい X API v2 エンドポイントへの移行を検討している場合は、このガイドが役立ちます。

​
最近検索の比較

次の表は、さまざまな種類の最近検索エンドポイントを比較したものです。
説明Standard v1.1X API v2
ホストドメインhttps://api.x.comhttps://api.x.com
エンドポイントパス/1.1/search/tweets.json/2/tweets/search/recent
認証OAuth 1.0a User Context
OAuth 2.0 App-Only		OAuth 1.0a User Context

OAuth 2.0 Authorization Code with PKCE

OAuth 2.0 App-Only
タイムスタンプ形式YYYYMMDDYYYY-MM-DDTHH:mm:ssZ
ISO 8601 / RFC 3339
返される投稿の最長経過期間7 days7 days
対応している HTTP メソッドGETGET
デフォルトのリクエストのレート制限OAuth 1.0a User Context で 15 分あたり 180 リクエスト

OAuth 2.0 App-Only で 15 分あたり 450 リクエスト		セルフサービス:

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

OAuth 1.0a User Context で 15 分あたり 60 リクエスト

OAuth 2.0 Authorization Code with PKCE で 15 分あたり 60 リクエスト
完全に展開された URL を提供✔
レスポンスごとの最大投稿数 (デフォルト)100 (15)100 (10)
投稿の JSON 形式Standard v1.1 形式X API v2 形式 (fields と expansions リクエストパラメータによって決まり、v1.1 形式との後方互換性はありません)

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

​
全履歴検索の比較

次の表では、さまざまな種類の全履歴検索エンドポイントを比較します。
説明EnterpriseX 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
返されるポストの最も古い日時2006年3月以降の全履歴2006年3月以降の全履歴
対応している HTTP メソッドGET
POST		GET
デフォルトのリクエストレート制限1分あたりのレート制限は、契約で指定されたとおりパートナーごとに異なります。

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

OAuth 2.0 App-Only で 1 秒あたり 1 リクエスト
完全に展開された URL を返す✔✔
レスポンスあたりの投稿数最大: 500
デフォルト: 100		最大: 500
デフォルト: 10
ポスト JSON 形式Native Enriched または Activity Streams 形式X API v2 形式 (fields と expansions のリクエストパラメータによって決定)
ペイロード内で返すフィールドを選択可能✔
annotations のリクエストおよび受信をサポート✔
ポストオブジェクト内で特定のmetricsをリクエストすることをサポート✔
conversation_id 演算子とフィールドをサポート✔
ポスト編集履歴を提供✔✔
ポストデータ配列の JSON キー名resultsdata
ページネーション用 JSON キー名nextmeta.next_token
時間ベースのリクエストの時間分解能秒秒
タイムゾーンUTCUTC
ポスト ID によるアーカイブのナビゲーションをサポート✔
時刻によるナビゲーション用リクエストパラメータfromDate
toDate		start_time
end_time
ポスト ID によるナビゲーション用リクエストパラメータsince_id
until_id
ページネーション用リクエストパラメータnext_tokennext_token
Academic Research アクセスを持つ Project に関連付けられた developer App の認証情報の使用が必須✔
フィルタリング演算子の比較 ポスト検索の 4 つのバージョン (standard、enterprise、v2) は、利用可能な演算子が異なり、さらに各バージョン内でも演算子の利用レベルが異なります。これらについては以下で説明します。 Enterprise
  • Enterprise 演算子にサブレベルはありません
X API v2
  • Self-serve: 任意の Project を使用している場合に利用可能
  • Enterprise: Project を使用している場合に利用可能
これらそれぞれの演算子セットの詳細は、対応するガイドで確認できます。 X API v2 内の異なる演算子レベルを理解したところで、ポスト検索における演算子の利用可否をマッピングした次の表を見ていきます (セルが空白の場合、その演算子は利用できません) 。
検索演算子StandardEnterprisev2
keyword利用可能
q:keyword		利用可能利用可能
emoji利用可能
q:😄		利用可能利用可能
”exact phrase”利用可能利用可能利用可能
#利用可能利用可能利用可能
$利用可能利用可能利用可能
@利用可能利用可能利用可能
from:利用可能利用可能利用可能
to:利用可能利用可能利用可能
url:利用可能利用可能利用可能
retweets_of:利用可能利用可能
context:利用可能
entity:セルフサービス - recent search でのみ利用可能
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 移行ハブ これらのエンドポイントのサンプルコードを確認する 投稿検索: Standard v1.1 から X API v2 への移行 投稿検索: Enterprise から X API v2 への移行