> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 概要
## X API のタイムラインエンドポイントの比較
v2 の逆時系列タイムライン、ユーザー投稿タイムライン、ユーザーのメンションタイムラインの各エンドポイントは、それぞれ [v1.1 statuses/home\_timeine](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-home_timeline)、[v1.1 statuses/user\_timeline](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-user_timeline.html)、[v1.1 statuses/mentions\_timeline](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-mentions_timeline.html) エンドポイントを置き換えるものです。これらの旧バージョンのエンドポイントを使用しているコード、App、またはツールがあり、新しい X API v2 エンドポイントへの移行を検討している場合は、本ガイドが役立ちます。より詳細な移行ガイドについては、[Standard v1.1 migration to X API v2](/ja/x-api/posts/timelines/migrate/standard-to-twitter-api-v2) を参照してください。
このページには、次の 3 つの比較表が含まれます。
* 逆時系列ホームタイムライン
* ユーザー投稿タイムライン
* ユーザーのメンションタイムライン
### 逆時系列のホームタイムライン
次の表では、標準の v1.1 と X API v2 のホームタイムラインエンドポイントを比較します。
| | | |
| :------------------------------------------------------------------------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **概要** | **Standard v1.1** | **X API v2** |
| ドキュメント | [APIリファレンス](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-home_timeline) | [APIリファレンス](https://developer.x.com/x-api/posts/timelines#user-mention-timeline-3) |
| 対応する 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 認可コードフロー](/ja/resources/fundamentals/authenticationoauth-2-0/authorization-code) |
| リクエストのレート制限 | 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](/ja/x-api/fundamentals/post-annotations) のリクエストおよび受信に対応 | 該当なし | `tweet.fields` に annotations が含まれている場合、結果にはポスト本文に基づいて推定されたアノテーションデータが含まれます。例えば「Music Genre」と「Folk Music」や、「Musician」と「Dolly Parton」などです。 |
| 特定のポストの [メトリクス](/ja/x-api/fundamentals/metrics) をリクエストして受信することをサポート | 該当なし | `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](/ja/x-api/fundamentals/conversation-id) のリクエストおよび受信をサポート | 該当なし | 返信スレッド内で最初に公開されたポストを表す値を持つ conversation\_id フィールドを返し、会話を追跡できるようにします。 |
| ポストの JSON 形式 | [Standard v1.1 データ形式](https://developer.x.com/en/docs/twitter-api/v1/data-dictionary/overview.html) | [X API v2](/ja/x-api/fundamentals/data-dictionary) フォーマット (`fields` および `expansions` リクエストパラメータによって決まり、v1.1 フォーマットとの後方互換性はありません)
Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法の詳細については、[データフォーマット移行ガイド](/ja/x-api/migrate/data-format-migration)をご覧ください。 |
| 結果の並び順 | 時系列の逆順 | 時系列の逆順 |
| 結果のページネーション | 該当なし。ポストIDによるナビゲーションを使用する必要があります | 結果は pagination\_token を使用して前後にたどって参照できます |
| [Project](/ja/resources/fundamentals/developer-apps) に関連付けられた [開発者用 App](/ja/resources/fundamentals/developer-apps) の認証情報を使用する必要があります | | ✔ |
### ユーザーポストタイムライン
次の表では、標準の v1.1 と X API v2 におけるユーザーポストタイムラインのエンドポイントを比較します。
| | | |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Description** | **Standard v1.1** | **X API v2** |
| Documentation | [APIリファレンス](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-user_timeline.html) | [APIリファレンス](/ja/x-api/posts/user-posts-timeline-by-user-id) |
| HTTP methods supported | GET | GET |
| Host domain | [https://api.x.com](https://api.x.com) | [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](/ja/x-api/fundamentals/post-annotations) | N/A | ポストテキストに基づき推定されたアノテーションデータ (例: 「Music Genre」と「Folk Music」、または「Musician」と「Dolly Parton」など) が付与されたポスト結果を返します |
| Supports requesting and receiving specific Post [metrics](/ja/x-api/fundamentals/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](/ja/x-api/fundamentals/conversation-id) | N/A | reply スレッドにおける最初に公開されたポストを表す値を持つ conversation\_id フィールドを返し、会話の追跡に役立てることができます。 |
| Post JSON format | [Standard v1.1 data format](/ja/x-api/fundamentals/data-dictionary) | [X API v2](/ja/x-api/fundamentals/data-dictionary) フォーマット (返却されるフィールドおよび expansions リクエストパラメータによって決定され、v1.1 フォーマットとの後方互換性はありません)
Standard v1.1 フォーマットから X API v2 フォーマットへの移行方法について詳しくは、[データフォーマット移行ガイド](/ja/x-api/migrate/data-format-migration)をご覧ください。 |
| Results order | 新しい順 (逆時系列) | 新しい順 (逆時系列) |
| Results pagination | N/A (ポスト ID によるナビゲーションを使用する必要があります) | pagination\_token を使用して、結果を前方または後方にたどって確認できます |
| Requires the use of credentials from a [developer App](/ja/resources/fundamentals/developer-apps) associated with a [Project](/ja/resources/fundamentals/developer-apps) | | ✔ |
| Provides Post edit history | ✔ | ✔ |
### ユーザーメンションタイムライン
以下の表は、Standard v1.1 と X API v2 のユーザーメンションタイムラインエンドポイントを比較したものです。
| | | |
| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Description** | **Standard v1.1** | **X API v2** |
| Documentation | [APIリファレンス](https://developer.x.com/en/docs/twitter-api/v1/tweets/timelines/api-reference/get-statuses-mentions_timeline.html) | [APIリファレンス](/ja/x-api/posts/user-mention-timeline-by-user-id) |
| HTTP methods supported | GET | GET |
| Host domain | [https://api.x.com](https://api.x.com) | [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](/ja/x-api/fundamentals/post-annotations) | 該当なし | ポストのテキストに基づいて推論されたアノテーションデータ (例: 'Music Genre' と 'Folk Music'、または 'Musician' と 'Dolly Parton' など) 付きの投稿結果を返します。 |
| Supports requesting and receiving specific Post [metrics](/ja/x-api/fundamentals/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](/ja/x-api/fundamentals/conversation-id) | 該当なし | reply スレッド内で最初に公開されたポストを表す値を持つ conversation\_id フィールドを返し、会話を追跡できるようにします。 |
| Post JSON format | [Standard v1.1 データ形式](/ja/x-api/fundamentals/data-dictionary) | [X API v2 形式](/ja/x-api/fundamentals/data-dictionary) (fields と expansions リクエストパラメータによって決定され、v1.1 形式との後方互換性はありません)
Standard v1.1 形式から X API v2 形式への移行方法の詳細については、[データ形式の移行ガイド](/ja/x-api/migrate/data-format-migration)をご覧ください。 |
| Results order | 新しいものから順 (逆時系列) | 新しいものから順 (逆時系列) |
| Request parameters for pagination | 該当なし。ポスト ID によるナビゲーションを使用する必要があります | pagination\_token を使用して、結果を前後に移動しながら確認できます |
| Requires the use of credentials from a [developer App](/ja/resources/fundamentals/developer-apps) associated with a [Project](/ja/resources/fundamentals/developer-apps) | | ✔ |
| Provides Post edit history | ✔ | ✔ |
**その他の移行用リソース**
[Post lookup: Standard v1.1 から X API v2 への移行](/ja/x-api/posts/lookup/migrate/standard-to-twitter-api-v2 "Post lookup: Standard v1.1 から X API v2 への移行")
[X API 移行ハブ](/ja/x-api/migrate/overview)