メインコンテンツへスキップ
これら3つのタイムライン endpoint は、編集済みの Posts をサポートします。これらの endpoint は常に最新の編集内容と編集履歴を返します。30分の編集ウィンドウの終了後に取得された Post は、最終版を表します。編集 metadata には、その履歴内のすべての Post の id の配列が含まれます。編集履歴のない Posts の場合、この配列には単一の id が格納されます。編集が行われた Posts の場合、この配列には複数の id が含まれ、編集順を反映した昇順で並び、配列の最後に最新バージョンが位置します。Post の編集の仕組みについて詳しくは、Edit Posts fundamentals ページをご覧ください。

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

この endpoint では、認証済みユーザーとそのフォロー先アカウントが投稿した最新の Posts、リツイート、返信を取得できます。 ユーザーの代理でリクエストを行うため、これらの endpoint は OAuth 2.0 Authorization Code Flow with PKCE または OAuth 1.0a ユーザーコンテキスト を使用して認証する必要があります。この endpoint のレートリミットは、ユーザーごとに15分あたり180リクエストです。また、この endpoint は、直近7日間にタイムライン上で作成されたすべての Postに加え、作成日時に関係なく最新の800件も返すことができます。

​
ユーザーのPostタイムライン

ユーザーのPostタイムラインendpointは、特定のXアカウントが公開したPostsへのアクセスを提供します。ユーザーのPostsを取得することで、UIにタイムラインを表示したり、ユーザーのPostsを分析してコンテンツを深く理解したり、プログラムでPostsを用いたエンゲージメントのワークフローを構築したりできます。このendpointでは、ユーザーのプロフィールタイムラインで見られる内容に近い形で、単一のXアカウントの最新のPosts、リツイート、返信、引用Tweetにアクセスできます。 以下は @XDevelopers のユーザータイムラインです: ユーザーのPostタイムラインendpointは、対象ユーザー（ユーザーID指定）を示すための単一のパスパラメータを受け取るREST endpointです。このendpointは、そのユーザーが投稿した最新3,200件までのPosts、リツイート、返信、引用Tweetを返せます。 Postsは新しいものからの逆時系列で返されます。結果は1ページあたり最大100件のPostsでページネーションされます。大量のPostsをページングするためのページネーショントークンが提供されます。指定ページに含まれる最も新しいPostと最も古いPostのPost IDもmetadataとして提供され、直近のPostsをポーリングする際にも利用できます。ユーザーのPostタイムラインは、特定の時間範囲内に作成されたPostsを受け取るために、start_timeおよびend_timeパラメータの指定もサポートしています。  ユーザーのPostタイムラインendpointは、fieldsおよびexpansionsパラメータをサポートし、新しいJSONデータ形式を返します。 このendpointへ正常にリクエストするには、OAuth 1.0a ユーザーコンテキスト、OAuth 2.0 Authorization Code（PKCE 付き）、またはOAuth 2.0 App-Onlyの認証方式でリクエストを認可する必要があります。非公開metrics、プロモーションmetrics、または保護されたユーザーのタイムラインをリクエストする場合は、OAuth 1.0a ユーザーコンテキストまたはOAuth 2.0 Authorization Code（PKCE 付き）を使用する必要があります。  ユーザーのPostタイムラインendpointは、次の2つの一般的な利用パターンを想定して設計されています。 
  • “ユーザーの過去のPostsを取得する”: 直近の特定期間にわたり、関心のあるユーザーが作成したPostsを時系列で受け取るためにユーザーのPostタイムラインへ行うリクエスト。期間はstart_timeとend_timeで設定し、結果全体をページネーションして取得します。場合によっては、当該ユーザーのPostsが3,200件以内であれば、Postの全履歴を取得できます。含まれるPostsは公開状況や使用する認証に依存します。
  • “新しいPostsのポーリング”: 特定ユーザーが作成した新しいPostsを継続的に取得するために、定期的にユーザーのPostタイムラインへ行うリクエスト。最後に受け取ったPostのPost IDを、前回以降の新規リクエストのパラメータとして指定できます。

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

ユーザーのメンションタイムライン endpoint は、特定の X ユーザーに言及している Posts をリクエストできます。たとえば、ある X アカウントが Post 内で @XDevelopers に言及している場合などです。これには、リクエスト対象のユーザーによる Posts への返信も含まれます。ユーザーのメンションを取得すると、ユーザーの Posts に誰が返信・言及しているかをすばやく把握したり、その Posts に対するエンゲージメントのワークフローをプログラムで構築したりできます。endpoint では、単一ユーザーの最新のメンションおよび返信をリクエストでき、X 上のユーザーのメンションの通知で見られる内容に近い結果を取得できます。 ユーザーのメンションタイムラインは、目的のユーザー（ユーザー ID 指定）を示す単一のパスパラメータを受け取る REST endpoint です。この endpoint は、そのユーザーに対する直近 800 件のメンションを返せます。 Posts は最新のものからの逆時系列で返されます。結果は 1 ページあたり最大 100 件の Posts でページネーションされます。大量の Posts をページングするためのページネーショントークンが提供されます。指定ページに含まれる最も新しいおよび最も古い Posts の Post ID も metadata として提供され、最近の Posts のポーリングや、v1.1 の mentions_timeline endpoint と同様にタイムラインを移動する用途にも使用できます。また、start_time および end_time パラメータを指定して、特定の時間範囲内に作成された Posts を受け取ることも可能です。  この endpoint に正常にリクエストするには、OAuth 1.0a ユーザーコンテキスト、OAuth 2.0 Authorization Code（PKCE 付き）、または OAuth 2.0 App-Only の認証方法でリクエストを承認する必要があります。非公開 metrics、プロモーション metrics、または保護されたユーザーのタイムラインをリクエストする場合は、OAuth 1.0a ユーザーコンテキストまたは OAuth 2.0 Authorization Code（PKCE 付き）を使用する必要があります。 ユーザーのメンションタイムライン endpoint は、fields および expansions パラメータをサポートし、新しい JSON data 形式を返します。
アカウントのセットアップこれらの endpoint にアクセスするには、以下が必要です。X API v2 endpoint へのアクセス方法の詳細は、はじめにガイドをご覧ください。
参考リソース Postman を使ったリクエスト方法を学ぶ エラーのトラブルシューティング この endpoint の API リファレンスページを参照
⌘I