タイムライン

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

概要

ユーザーの投稿

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

ユーザーへの言及

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

ホームタイムライン

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

逆時系列

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

エンドポイント

Method	Endpoint	Description
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"

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

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

はじめに

前提条件

承認済みの開発者アカウント
開発者コンソールで作成した Project と App
App のキーとトークン

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

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

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

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

統合ガイド

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

サンプルコード

実行可能なコード例