概要

X API のタイムラインエンドポイントの比較

v2 の逆時系列タイムライン、ユーザー投稿タイムライン、ユーザーのメンションタイムラインの各エンドポイントは、それぞれ v1.1 statuses/home_timeine、v1.1 statuses/user_timeline、v1.1 statuses/mentions_timeline エンドポイントを置き換えるものです。これらの旧バージョンのエンドポイントを使用しているコード、App、またはツールがあり、新しい X API v2 エンドポイントへの移行を検討している場合は、本ガイドが役立ちます。より詳細な移行ガイドについては、Standard v1.1 migration to X API v2 を参照してください。

このページには、次の 3 つの比較表が含まれます。

• 逆時系列ホームタイムライン
• ユーザー投稿タイムライン
• ユーザーのメンションタイムライン

逆時系列のホームタイムライン

次の表では、標準の v1.1 と X API v2 のホームタイムラインエンドポイントを比較します。

概要	Standard v1.1	X API v2
ドキュメント	APIリファレンス	APIリファレンス
対応する HTTP メソッド	GET	GET
ホストドメイン	https://api.x.com	https://api.x.com
エンドポイントパス	/1.1/statuses/home_timeline.json	/2/users/:id/timelines/reverse_chronological
必須パラメータ	user_id または screen_name	パスパラメータ :id に指定されたユーザーID
認証	OAuth 1.0a ユーザーコンテキスト	OAuth 1.0a ユーザーコンテキスト PKCE を用いた OAuth 2.0 認可コードフロー
リクエストのレート制限	OAuth 1.0a User Context では 15 分間あたり 15 リクエスト リクエスト上限: 24 時間あたり 100,000 リクエスト。	15 分間で 180 リクエストまで
レスポンスあたりのデフォルト投稿数	15	100
レスポンスあたりの最大投稿数	800	このエンドポイントは、タイムライン上で過去 7 日間に作成されたすべてのポストに加え、作成日時に関係なく直近 800 件のポストを返します。
ポストの編集履歴を提供	✔	✔
取得可能な過去の投稿	直近 800 件の投稿 (リツイートを含む)	直近 3,200 件の投稿 (リツイートを含む)
タイムラインのナビゲーションオプション	since_id (排他的) : 更新ポーリングに使用されます max_id (包括的)	start_time end_time 更新ポーリング用の since_id (排他的) until_id (排他的)
結果を絞り込むためのオプションパラメータ	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
annotations のリクエストおよび受信に対応	該当なし	tweet.fields に annotations が含まれている場合、結果にはポスト本文に基づいて推定されたアノテーションデータが含まれます。例えば「Music Genre」と「Folk Music」や、「Musician」と「Dolly Parton」などです。
特定のポストの メトリクス をリクエストして受信することをサポート	該当なし	tweet.fields に annotations が含まれている場合、結果にはポストごとの public_metrics (retweet_count、reply_count、quote_count、like_count) および impression_count、user_profile_clicks、url_link_clicks などを含む non_public_metrics が付与されます。 view_count や動画再生メトリクスなどの追加のメディアメトリクスも提供されます。 プロモーションされたポストに対しては、User Context を利用することで、追加の organic_metrics および promoted_metrics が利用可能です。
conversation_id のリクエストおよび受信をサポート	該当なし	返信スレッド内で最初に公開されたポストを表す値を持つ conversation_id フィールドを返し、会話を追跡できるようにします。
ポストの JSON 形式	Standard v1.1 データ形式	X API v2 フォーマット (fields および expansions リクエストパラメータによって決まり、v1.1 フォーマットとの後方互換性はありません) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法の詳細については、データフォーマット移行ガイドをご覧ください。
結果の並び順	時系列の逆順	時系列の逆順
結果のページネーション	該当なし。ポストIDによるナビゲーションを使用する必要があります	結果は pagination_token を使用して前後にたどって参照できます
Project に関連付けられた 開発者用 App の認証情報を使用する必要があります		✔

ユーザーポストタイムライン

次の表では、標準の v1.1 と X API v2 におけるユーザーポストタイムラインのエンドポイントを比較します。

Description	Standard v1.1	X API v2
Documentation	APIリファレンス	APIリファレンス
HTTP methods supported	GET	GET
Host domain	https://api.x.com	https://api.x.com
Endpoint paths	/1.1/statuses/user_timeline.json	/2/users/:id/tweets
Required parameters	user_id または screen_name	:id としてパスパラメータに設定された User ID
Authentication	OAuth 1.0a User Context OAuth 2.0 App-Only	OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE
Request rate limits	OAuth 1.0a User Context では 15 分あたり 900 リクエスト OAuth 2.0 App-Only では 15 分あたり 1500 リクエスト リクエスト上限: 24 時間あたり 100,000 件。	OAuth 1.0a User Context では 15 分ウィンドウあたり 900 リクエスト OAuth 2.0 App-Only では 15 分ウィンドウあたり 1500 リクエスト
Default Posts per response	レスポンスごとのポストのデフォルト数: 15	レスポンスごとのポストのデフォルト数: 10
Maximum Posts per response	レスポンスごとのポストの最大数: 200	レスポンスごとのポストの最大数: 100
Historical Posts available	直近 3,200 件の投稿 (リツイートを含む)	直近 3,200 件の投稿 (リツイートを含む)
Timeline navigation options	since_id (排他的。更新ポーリング用) max_id (包括的)	start_time end_time since_id (排他的。更新ポーリング用) until_id (排他的)
Optional parameters for results refinement	count exclude_replies include_rts trim_user tweet_mode since_id max_id	max_results exclude(retweets,replies) tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Supports requesting and receiving annotations	N/A	ポストテキストに基づき推定されたアノテーションデータ (例: 「Music Genre」と「Folk Music」、または「Musician」と「Dolly Parton」など) が付与されたポスト結果を返します
Supports requesting and receiving specific Post metrics	N/A	ポストごとの利用可能な public_metrics (retweet_count、reply_count、quote_count、like_count など) を含むポスト結果を返します。 OAuth 1.0a User Context で利用可能: impression_count、user_profile_clicks、url_link_clicks など、追加の non_public_metrics。 view_count や動画再生メトリクスなど、追加のメディアメトリクス。 プロモーション済みポスト向けに、OAuth 1.0a User Context で利用可能な追加の organic_metrics および promoted_metrics。
Supports requesting and receiving conversation_id	N/A	reply スレッドにおける最初に公開されたポストを表す値を持つ conversation_id フィールドを返し、会話の追跡に役立てることができます。
Post JSON format	Standard v1.1 data format	X API v2 フォーマット (返却されるフィールドおよび expansions リクエストパラメータによって決定され、v1.1 フォーマットとの後方互換性はありません) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法について詳しくは、データフォーマット移行ガイドをご覧ください。
Results order	新しい順 (逆時系列)	新しい順 (逆時系列)
Results pagination	N/A (ポスト ID によるナビゲーションを使用する必要があります)	pagination_token を使用して、結果を前方または後方にたどって確認できます
Requires the use of credentials from a developer App associated with a Project		✔
Provides Post edit history	✔	✔

ユーザーメンションタイムライン

以下の表は、Standard v1.1 と X API v2 のユーザーメンションタイムラインエンドポイントを比較したものです。

Description	Standard v1.1	X API v2
Documentation	APIリファレンス	APIリファレンス
HTTP methods supported	GET	GET
Host domain	https://api.x.com	https://api.x.com
Endpoint paths	/1.1/statuses/mentions_timeline.json	/2/users/:id/mentions
Required parameters	必須パラメータなし	User ID を :id パスパラメータとして指定
Authentication	OAuth 1.0a User Context	OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE
Default request rate limits	OAuth 1.0a User Context の場合、15 分あたり 75 リクエスト 24 時間あたり 100,000 リクエストの上限。	OAuth 1.0a User Context の場合、15 分あたり 180 リクエスト OAuth 2.0 App-Only の場合、15 分あたり 450 リクエスト
Default Posts per response	レスポンスあたりのデフォルトの投稿数: 15	レスポンスあたりのデフォルトの投稿数: 10
Maximum Posts per response	レスポンスあたりの最大投稿数: 200	レスポンスあたりの最大投稿数: 100
Historical Posts available	利用可能な履歴投稿: 直近 800 件の投稿	利用可能な履歴投稿: 直近 800 件の投稿
Timeline navigation options	since_id (排他的) を使用した更新ポーリング max_id (包括的)	start_time end_time since_id (排他的) を使用した更新ポーリング until_id (排他的)
Optional parameters for results refinement	count trim_user include_entities tweet_mode since_id max_id	max_results tweet.fields user.fields place.fields media.fields poll.fields expansions start_time end_time since_id until_id
Supports requesting and receiving annotations	該当なし	ポストのテキストに基づいて推論されたアノテーションデータ (例: ‘Music Genre’ と ‘Folk Music’、または ‘Musician’ と ‘Dolly Parton’ など) 付きの投稿結果を返します。
Supports requesting and receiving specific Post metrics	該当なし	各ポストごとに利用可能な public_metrics (retweet_count、reply_count、quote_count、like_count など) を含むポスト結果を返します。 OAuth 1.0a User Context で利用可能: impression_count、user_profile_clicks、url_link_clicks など、追加の non_public_metrics。 view_count や動画再生メトリクスなどの追加のメディアメトリクス。 プロモーションされたポスト向けに、OAuth 1.0a User Context で利用可能な追加の organic_metrics および promoted_metrics。
Supports requesting and receiving conversation_id	該当なし	reply スレッド内で最初に公開されたポストを表す値を持つ conversation_id フィールドを返し、会話を追跡できるようにします。
Post JSON format	Standard v1.1 データ形式	X API v2 形式 (fields と expansions リクエストパラメータによって決定され、v1.1 形式との後方互換性はありません) Standard v1.1 形式から X API v2 形式への移行方法の詳細については、データ形式の移行ガイドをご覧ください。
Results order	新しいものから順 (逆時系列)	新しいものから順 (逆時系列)
Request parameters for pagination	該当なし。ポスト ID によるナビゲーションを使用する必要があります	pagination_token を使用して、結果を前後に移動しながら確認できます
Requires the use of credentials from a developer App associated with a Project		✔
Provides Post edit history	✔	✔

その他の移行用リソース

Post lookup: Standard v1.1 から X API v2 への移行

X API 移行ハブ