概要 - X

X API の Search Posts エンドポイントを比較する

v2 Search Tweets エンドポイントは、最終的に standard v1.1 search/posts エンドポイントと Enterprise Search API を置き換えます。X search エンドポイントの旧バージョンを使用したコード、アプリ、ツールをお持ちで、より新しい X API v2 エンドポイントへの移行を検討中の場合、本ガイドが役立ちます。

Recent search の比較

以下の表は、さまざまなタイプの recent search エンドポイントを比較しています:

Description	Standard v1.1	X API v2
Host domain	https://api.x.com	https://api.x.com
Endpoint path	/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
Timestamp format	YYYYMMDD	YYYY-MM-DDTHH:mm:ssZ ISO 8601 / RFC 3339
返される投稿の対象期間	7 日以内	7 日以内
サポートする HTTP メソッド	GET	GET
デフォルトのリクエストレート制限	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)
Post JSON フォーマット	Standard v1.1 フォーマット	X API v2 フォーマット(fields と expansions リクエストパラメーターで決定、v1.1 フォーマットとは後方互換性なし) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法については、データフォーマット移行ガイドを参照してください。
ペイロードに返すフィールドの選択をサポート		✔
annotations のリクエストと受信をサポート		✔
Post オブジェクト内の特定のメトリクスのリクエストをサポート		✔
conversation_id 演算子とフィールドをサポート		✔
投稿の編集履歴を提供	✔	✔
Post データ配列の JSON キー名	statuses	data
ページネーションの JSON キー名	search_metadata.next_results	meta.next_token
時間範囲によるアーカイブ移動をサポート	✔	✔
時間ベースリクエストの時間解像度	日	秒
タイムゾーン	UTC	UTC
時間で移動するリクエストパラメーター	until	start_time end_time
Post ID で移動するリクエストパラメーター	since_id max_id	since_id until_id
ページネーション用リクエストパラメーター	URL エンコードされたクエリを提供	next_token
Project に紐づく開発者 App の認証情報が必要		✔

Full-archive search の比較

以下の表は、さまざまなタイプの full-archive search エンドポイントを比較しています:

Description	Enterprise	X API v2
Host domain	https://gnip-api.x.com	https://api.x.com
Endpoint path	/search/fullarchive/accounts/:account_name/:label	/2/tweets/search/all
認証	Basic auth	OAuth 2.0 App-Only
Timestamp format	YYYYMMDDHHMM	YYYY-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
Post JSON フォーマット	Native Enriched または Activity Streams フォーマット	X API v2 フォーマット(fields と expansions リクエストパラメーターで決定)
ペイロードに返すフィールドの選択をサポート		✔
annotations のリクエストと受信をサポート		✔
Post オブジェクト内の特定のメトリクスのリクエストをサポート		✔
conversation_id 演算子とフィールドをサポート		✔
投稿の編集履歴を提供	✔	✔
Post データ配列の JSON キー名	results	data
ページネーションの JSON キー名	next	meta.next_token
時間ベースリクエストの時間解像度	秒	秒
タイムゾーン	UTC	UTC
Post ID によるアーカイブ移動をサポート		✔
時間で移動するリクエストパラメーター	fromDate toDate	start_time end_time
Post ID で移動するリクエストパラメーター		since_id until_id
ページネーション用リクエストパラメーター	next_token	next_token
Academic Research アクセスを持つ Project に紐づく開発者 App の認証情報が必要		✔

フィルタリング演算子の比較 search Posts の 4 種類のバージョン(standard、Enterprise、v2)では利用可能な演算子が異なり、各バージョン内でも演算子の可用性に差があります。詳細は以下で説明します。 Enterprise

Enterprise 演算子にサブティアはありません

X API v2

セルフサーブ: 任意の Project で利用可能
Enterprise: Project で利用可能

各演算子セットの詳細は、それぞれのガイドをご覧ください:

X API v2 内の各演算子レベルを理解した上で、search Posts の演算子可用性を示す表を以下に示します(セルが空白の場合、その演算子は利用できません):

Search operator	Standard	Enterprise	v2
keyword	Available q:keyword	Available	Available
emoji	Available q:😄	Available	Available
”exact phrase”	Available	Available	Available
#	Available	Available	Available
$	Available	Available	Available
@	Available	Available	Available
from:	Available	Available	Available
to:	Available	Available	Available
url:	Available	Available	Available
retweets_of:		Available	Available
context:			Available
entity:			セルフサーブ - recent search でのみ利用可能
conversation_id:			Available
place:		Available	Available
place_country:		Available	Available
point_radius:	geocode パラメーター	Available	Available
bounding_box:		Available	Available
is:retweet	filter:retweets	Available	Available
is:reply		Available	Available
is:quote		Available	Available
is:verified		Available	Available
-is:nullcast		Available	Available
has:hashtags		Available	Available
has:cashtags		Available	Available
has:links	filter:links	Available	Available
has:mentions		Available	Available
has:media	filter:media	Available	Available
has:images	filter:images, filter:twimg	Available	Available
has:videos	filter:videos filter:native_video	Available	Available
has:geo		Available	Available
lang:	lang - 演算子またはパラメーターとして使用可能	Available	Available
has:profile_geo		Available
profile_country		Available
profile_locality		Available
profile_region		Available
proximity		Available
:(	Available
:)	Available
?	Available
filter:periscope	Available
list:	Available		Available
filter:replies	Available
filter:pro_video	Available
filter:social	Available
filter:trusted	Available
filter:follows	Available
filter:has_engagement	Available
include:antisocial	Available
include:offensive_user	Available
include:antisocial_offensive_user	Available
include:sensitive_content	Available
source:	Available
min_replies:	Available
min_retweets:	Available
min_faves:	Available
card_name:	Available
card_domain:	Available

その他の移行リソース X API 移行ハブこれらのエンドポイントのサンプルコードを確認する Search Posts: Standard v1.1 から X API v2 Search Posts: Enterprise から X API v2

Getting Started

Products

Fundamentals

Partners & Customers

Resources

概要

X API の Search Posts エンドポイントを比較する

Recent search の比較

Full-archive search の比較

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

​Recent search の比較

​Full-archive search の比較

X API の Search Posts エンドポイントを比較する

Recent search の比較

Full-archive search の比較