X API のタイムラインエンドポイントの比較
- 逆時系列ホームタイムライン
- ユーザー投稿タイムライン
- ユーザーのメンションタイムライン
逆時系列のホームタイムライン
| 概要 | 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_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 のリクエストおよび受信に対応 | 該当なし | 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 の認証情報を使用する必要があります | ✔ |
ユーザーポストタイムライン
| 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 | ✔ | ✔ |
ユーザーメンションタイムライン
| 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 | ✔ | ✔ |