メインコンテンツへスキップ
Timelines エンドポイントを使用すると、ユーザーのタイムライン、メンションフィード、ホームフィードから投稿を取得できます。ユーザーが投稿したコンテンツを取得したり、そのユーザーがメンションされている投稿を確認したり、パーソナライズされたホームタイムラインを表示したりできます。

概要

ユーザーの投稿

ユーザーが投稿した投稿を取得します

ユーザーへの言及

ユーザーへの言及を含む投稿を取得します

ホームタイムライン

パーソナライズされたホームフィードを取得します

逆時系列

投稿を時系列順で取得します

エンドポイント

MethodEndpointDescription
GET/2/users/:id/tweets指定したユーザーの投稿を取得
GET/2/users/:id/mentions指定したユーザーへの言及を含む投稿を取得
GET/2/users/:id/timelines/reverse_chronologicalホームタイムラインを取得

ユーザー投稿のタイムライン

特定のユーザーが作成した最新の投稿を取得します。

機能

  • 直近3,200件までの投稿を取得可能
  • 返信とリツイートを除外可能
  • ページネーションをサポート
  • 時間ベースのフィルタリングによる過去データへのアクセス

APIリファレンス

エンドポイントの完全なドキュメント

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

特定のユーザーがメンションされている投稿を取得します。

機能

  • 直近のメンションを最大800件まで取得
  • 返信と引用ポストを含む
  • ページネーションをサポート

クイックスタート

ユーザーのメンションを取得

APIリファレンス

エンドポイントの完全なドキュメント

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

認証済みユーザーのホームタイムラインを、最新の投稿から順に取得します。

機能

  • フォローしているアカウントの投稿
  • 直近3,200件の投稿 (または過去7日分)
  • アルゴリズムによるランキングなし
  • ユーザー認証が必要
このエンドポイントには OAuth 1.0a User Context または OAuth 2.0 Authorization Code with PKCE が必要です。

クイックスタート

ユーザーのホームタイムラインを取得

APIリファレンス

エンドポイントの全仕様

フィルタリングのオプション

exclude パラメータ

特定のポストの種類を除外します:
効果
retweetsリツイートを除外
replies返信を除外
curl "https://api.x.com/2/users/123/tweets?exclude=retweets,replies" \
  -H "Authorization: Bearer $BEARER_TOKEN"

時間によるフィルタリング

ParameterDescription
start_time最も古いポストのタイムスタンプ (ISO 8601)
end_time最も新しいポストのタイムスタンプ (ISO 8601)
since_idこのIDより後の投稿を返します
until_idこのIDより前の投稿を返します

はじめに

前提条件

ホームタイムラインのクイックスタート

ユーザーのホームフィードを取得

メンションのクイックスタート

ユーザーのメンションを取得

統合ガイド

基本概念とベストプラクティス

サンプルコード

実行可能なコード例