X API のタイムラインエンドポイントを比較する
v2 の逆時系列タイムライン、ユーザーの投稿タイムライン、およびユーザーのメンションタイムラインのエンドポイントは、それぞれ v1.1 statuses/home_timeline,、v1.1 statuses/user_timeline、および v1.1 statuses/mentions_timeline エンドポイントを置き換えます。このエンドポイントの旧バージョンを使用したコード、アプリ、ツールをお持ちで、より新しい X API v2 エンドポイントへの移行を検討中の場合、本ガイドが役立ちます。詳細な移行ガイドは Standard v1.1 から X API v2 への移行を参照してください。 このページには 3 つの比較表があります:- 逆時系列ホームタイムライン
- ユーザーの投稿タイムライン
- ユーザーのメンションタイムライン
逆時系列ホームタイムライン
以下の表は standard v1.1 と X API v2 のホームタイムラインエンドポイントを比較しています:| Description | Standard v1.1 | X API v2 |
| ドキュメント | API リファレンス | API リファレンス |
| サポートする HTTP メソッド | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /1.1/statuses/home_timeline.json | /2/users/:id/timelines/reverse_chronological |
| 必須パラメーター | user_id または screen_name | パスパラメーター :id に設定されたユーザー ID |
| 認証 | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 Authorization Code Flow with PKCE |
| リクエストレート制限 | OAuth 1.0a User Context で 15 分あたり 15 リクエスト リクエスト上限: 24 時間あたり 100,000 件。 | 15 分ウィンドウあたり 180 リクエスト |
| レスポンスあたりのデフォルト投稿数 | 15 | 100 |
| レスポンスあたりの最大投稿数 | 800 | このエンドポイントは、直近 7 日間にタイムライン上で作成されたすべての投稿と、作成日時にかかわらず最新 800 件を返します。 |
| 投稿の編集履歴を提供 | ✔ | ✔ |
| 利用可能な履歴投稿 | 最新 800 件の投稿(Retweet を含む) | 最新 3,200 件の投稿(Retweet を含む) |
| タイムラインナビゲーションオプション | since_id(排他的)、更新ポーリング用max_id(包含的) | start_timeend_time since_id(排他的)、更新ポーリング用until_id(排他的) |
| 結果精緻化用のオプションパラメーター | countexclude_repliesinclude_rtstrim_usertweet_modesince_idmax_id | max_resultsexclude(retweets,replies)tweet.fieldsuser.fieldsplace.fieldsmedia.fieldspoll.fieldsexpansionsstart_timeend_timesince_iduntil_id |
| annotations のリクエストと受信をサポート | N/A | tweet.fields に annotations が含まれる場合、結果は投稿テキストに基づく推論された annotation データ(‘Music Genre’ と ‘Folk Music’、‘Musician’ と ‘Dolly Parton’ など)で注釈されます |
| 特定の Post メトリクスのリクエストと受信をサポート | N/A | tweet.fields に annotations が含まれる場合、結果は Post ごとに public_metrics(retweet_count、reply_count、quote_count、like_count、impression_count、bookmark_count を含む)、non_public_metrics(impression_count、user_profile_clicks、url_link_clicks、engagements を含む)で注釈されます。view_count や動画再生メトリクスなどの追加メディアメトリクス。 プロモート投稿の場合、User Context で追加の organic_metrics と promoted_metrics が利用可能。 |
| conversation_id のリクエストと受信をサポート | N/A | 値が返信スレッドで最初に公開された投稿を表す conversation_id フィールドを返し、会話の追跡を支援します。 |
| Post JSON フォーマット | Standard v1.1 データフォーマット | X API v2 フォーマット(fields と expansions リクエストパラメーターで決定、v1.1 フォーマットとは後方互換性なし) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法については、データフォーマット移行ガイドを参照してください。 |
| 結果順 | 逆時系列 | 逆時系列 |
| 結果ページネーション | N/A、Post ID による移動を使用する必要あり | pagination_token を使用して結果を前後に移動可能 |
| Project に紐づく開発者 App の認証情報が必要 | ✔ |
ユーザーの投稿タイムライン
以下の表は standard v1.1 と X API v2 のユーザーの投稿タイムラインエンドポイントを比較しています:| Description | Standard v1.1 | X API v2 |
| ドキュメント | API リファレンス | API リファレンス |
| サポートする HTTP メソッド | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /1.1/statuses/user_timeline.json | /2/users/:id/tweets |
| 必須パラメーター | user_id または screen_name | パスパラメーター :id に設定されたユーザー ID |
| 認証 | 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 |
| リクエストレート制限 | 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 リクエスト |
| レスポンスあたりのデフォルト投稿数 | 15 | 10 |
| レスポンスあたりの最大投稿数 | 200 | 100 |
| 利用可能な履歴投稿 | 最新 3,200 件の投稿(Retweet を含む) | 最新 3,200 件の投稿(Retweet を含む) |
| タイムラインナビゲーションオプション | 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 のリクエストと受信をサポート | N/A | 投稿テキストに基づく推論された annotation データ(‘Music Genre’ と ‘Folk Music’、‘Musician’ と ‘Dolly Parton’ など)付きの投稿結果を返します |
| 特定の Post メトリクスのリクエストと受信をサポート | N/A | 利用可能な public_metrics(retweet_count、reply_count、quote_count、like_count を含む)付きの投稿結果を返します。 OAuth1.0a User Context で利用可能: 追加の non_public_metrics(impression_count、user_profile_clicks、url_link_clicks を含む)。 view_count や動画再生メトリクスなどの追加メディアメトリクス。 プロモート投稿の場合、OAuth 1.0a User Context で追加の organic_metrics と promoted_metrics が利用可能。 |
| conversation_id のリクエストと受信をサポート | N/A | 値が返信スレッドで最初に公開された投稿を表す conversation_id フィールドを返し、会話の追跡を支援します。 |
| Post JSON フォーマット | Standard v1.1 データフォーマット | X API v2 フォーマット(fields と expansions リクエストパラメーターで決定、v1.1 フォーマットとは後方互換性なし) Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法については、データフォーマット移行ガイドを参照してください。 |
| 結果順 | 逆時系列 | 逆時系列 |
| 結果ページネーション | N/A、Post ID による移動を使用する必要あり | pagination_token を使用して結果を前後に移動可能 |
| Project に紐づく開発者 App の認証情報が必要 | ✔ | |
| 投稿の編集履歴を提供 | ✔ | ✔ |
ユーザーのメンションタイムライン
以下の表は standard v1.1 と X API v2 のユーザーのメンションタイムラインエンドポイントを比較しています| Description | Standard v1.1 | X API v2 |
| ドキュメント | API リファレンス | API リファレンス |
| サポートする HTTP メソッド | GET | GET |
| Host domain | https://api.x.com | https://api.x.com |
| Endpoint paths | /1.1/statuses/mentions_timeline.json | /2/users/:id/mentions |
| 必須パラメーター | 必須パラメーターなし | パスパラメーター :id に設定されたユーザー ID |
| 認証 | OAuth 1.0a User Context | OAuth 1.0a User Context OAuth 2.0 App-Only OAuth 2.0 Authorization Code with PKCE |
| デフォルトのリクエストレート制限 | OAuth 1.0a User Context で 15 分あたり 75 リクエスト 24 時間あたり 100,000 件のリクエスト上限。 | OAuth 1.0a User Context で 15 分ウィンドウあたり 180 リクエスト OAuth 2.0 App-Only で 15 分ウィンドウあたり 450 リクエスト |
| レスポンスあたりのデフォルト投稿数 | 15 | 10 |
| レスポンスあたりの最大投稿数 | 200 | 100 |
| 利用可能な履歴投稿 | 最新 800 件の投稿 | 最新 800 件の投稿 |
| タイムラインナビゲーションオプション | since_id(排他的)、更新ポーリング用 max_id(包含的) | start_time end_time since_id(排他的)、更新ポーリング用 until_id(排他的) |
| 結果精緻化用のオプションパラメーター | 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 |
| annotations のリクエストと受信をサポート | N/A | 投稿テキストに基づく推論された annotation データ(‘Music Genre’ と ‘Folk Music’、‘Musician’ と ‘Dolly Parton’ など)付きの投稿結果を返します |
| 特定の Post メトリクスのリクエストと受信をサポート | N/A | 利用可能な public_metrics(retweet_count、reply_count、quote_count、like_count を含む)付きの投稿結果を返します。 OAuth 1.0a User Context で利用可能: 追加の non_public_metrics(impression_count、user_profile_clicks、url_link_clicks を含む)。 view_count や動画再生メトリクスなどの追加メディアメトリクス。 プロモート投稿の場合、OAuth 1.0a User Context で追加の organic_metrics と promoted_metrics が利用可能 |