メインコンテンツへスキップこれら3つのタイムラインエンドポイントは、編集済みのPostをサポートしています。これらのエンドポイントは、常に最新の編集内容と編集履歴を返します。30分の編集可能期間を過ぎて収集されたPostは、最終版として扱われます。編集メタデータには、履歴内のすべてのPostのID配列が含まれます。編集履歴のないPostでは、この配列にはIDが1つだけ含まれます。編集が行われたPostでは、この配列に複数のIDが含まれ、編集の順序を反映して昇順に並び、配列の最後が最新バージョンになります。Postの編集の仕組みについては、Edit Posts fundamentals ページをご覧ください。
このエンドポイントを使用すると、認証済みユーザーおよびそのフォロー中のアカウントが投稿した最新のPost、リツイート（Retweet）、返信を取得できます。
ユーザーの代わりにリクエストを行うため、これらのエンドポイントは OAuth 2.0 Authorization Code Flow with PKCE または OAuth 1.0a ユーザーコンテキスト を使用して認証する必要があります。このエンドポイントには、ユーザーごとに15分あたり180件のレート制限があります。このエンドポイントは、過去7日間にタイムライン上で作成されたすべてのPostに加え、作成日時にかかわらず直近の800件も返すことができます。
ユーザーのPostタイムラインエンドポイントは、特定のXアカウントが公開したPostへのアクセスを提供します。ユーザーのPostを取得することで、UIにタイムラインを表示したり、ユーザーのPostを分析してコンテンツをより深く理解したり、プログラムでPostを活用したエンゲージメントのワークフローを構築したりできます。このエンドポイントでは、ユーザープロフィールのタイムラインに表示される内容に近い、単一のXアカウントにおける最新のPost、Retweet、返信、Quote Tweetにアクセスできます。
@XDevelopers のユーザータイムラインはこちらです:
ユーザーのPostタイムラインエンドポイントはRESTエンドポイントで、対象ユーザー（ユーザーID）を示す単一のパスパラメータを受け取ります。このエンドポイントは、そのユーザーが投稿した最新3,200件のPost、Retweet、返信、Quote Tweetを返すことができます。
Postは新しいものから順（逆時系列）に返されます。結果は1ページあたり最大100件のPostでページネーションされます。大量のPostをページングするためのページネーショントークンが提供されます。さらに、該当ページに含まれる最も新しいPostと最も古いPostのPost IDもメタデータとして提供され、最近のPostをポーリングする際にも利用できます。ユーザーのPostタイムラインは、特定の時間範囲内に作成されたPostのみを受け取るために、start_timeおよびend_timeパラメータの指定にも対応しています。
ユーザーのPostタイムラインエンドポイントは、fields および expansions パラメータをサポートし、新しいJSONのdata形式を返します。
このエンドポイントへのリクエストを成功させるには、OAuth 1.0a User Context、OAuth 2.0 Authorization Code with PKCE、または OAuth 2.0 App-Only の認証方法でリクエストを認可する必要があります。非公開メトリクス、プロモーションメトリクス、または保護されたユーザーのタイムラインをリクエストする場合は、OAuth 1.0a User Context か OAuth 2.0 Authorization Code with PKCE を使用する必要があります。
ユーザーのPostタイムラインエンドポイントは、次の2つの一般的な利用パターンをサポートするように設計されています。
-
「ユーザーの過去のPostを取得する」: 特定の最近の期間にわたり、対象ユーザーが作成したPostを時系列で受け取るために、ユーザーのPostタイムラインへリクエストを行います。期間はstart_timeとend_timeで設定し、結果全体をページネーションして取得します。場合によっては、アカウントのPostが3,200件以下であれば、ユーザーのPost履歴をすべて取得できることがあります。含まれるPostは公開状況およびリクエストで使用する認証によって異なります。
-
「新しいPostのポーリング」: 特定のユーザーが作成した新しいPostを取得するため、継続的にユーザーのPostタイムラインへリクエストを行います。最後に受け取ったPostのIDを、前回以降の新規リクエストのパラメータとして指定できます。
ユーザーのメンションタイムラインエンドポイントでは、特定のXユーザーに言及しているPostをリクエストできます。たとえば、XアカウントがPost内で@XDevelopersに言及した場合などです。これは、リクエスト対象のユーザーのPostへの返信も含みます。ユーザーのメンションを取得すると、そのユーザーのPostに誰が返信しているかや、誰が言及しているかをすばやく見つけたり、Postに対するエンゲージメントのワークフローをプログラムで構築できます。このエンドポイントでは、X上のユーザーのメンション通知に近い形で、単一ユーザーの最新のメンションと返信をリクエストできます。
ユーザーのメンションタイムラインは、対象ユーザー（ユーザーID）を示す単一のパスパラメータを受け取るRESTエンドポイントです。このエンドポイントは、そのユーザーに対する最新800件のメンションを返せます。
Postは最新のものから逆時系列で返されます。結果は1ページあたり最大100件のPostでページネーションされます。大量のPostをページングするためのページネーショントークンが提供されます。指定されたページに含まれる最新および最古のPostのPost IDもメタデータとして提供され、これを使用して最近のPostをポーリングしたり、v1.1のmentions_timelineエンドポイントのようにタイムラインを移動できます。エンドポイントは、特定の時間範囲内に作成されたPostを取得するために、start_timeおよびend_timeパラメータの指定にも対応しています。
このエンドポイントにリクエストするには、OAuth 1.0a User Context、OAuth 2.0 Authorization Code with PKCE、またはOAuth 2.0 App-Onlyの認証方式でリクエストを認可する必要があります。非公開メトリクス、プロモーテッドメトリクス、または保護されたユーザーのタイムラインをリクエストする場合は、OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE を使用する必要があります。
ユーザーのメンションタイムラインエンドポイントはfieldsおよびexpansionsパラメータをサポートし、新しいJSONデータ形式を返します。
アカウントのセットアップこれらのエンドポイントにアクセスするには、次が必要です:X API v2 エンドポイントへのアクセス方法の詳細は、はじめにガイドをご覧ください。 
