Skip to main content
このガイドでは、Timelines エンドポイントをアプリケーションに統合するために必要な主要概念を扱います。

認証

エンドポイントの要件

非公開メトリクス

非公開メトリクスにアクセスするには、投稿の作成者の代理で認証する必要があります:
以下のフィールドは User Context 認証が必要です:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

Fields と expansions

デフォルトでは、レスポンスに idtextedit_history_tweet_ids のみが含まれます。追加データをリクエストします:

リクエスト例

cURL

主なフィールド

Fields と expansions ガイド

レスポンスのカスタマイズについて詳しく学ぶ

ページネーション

タイムラインはリクエストあたり最大 100 投稿を返します。より大規模な結果セットにはページネーションを使用します。

しくみ

  1. max_results を指定して最初のリクエストを行う
  2. meta オブジェクトから next_token を取得
  3. 次のリクエストに pagination_token を含める
  4. next_token が返されなくなるまで繰り返す

cURL

ページネーションガイド

ページネーションについて詳しく学ぶ

結果のフィルタリング

時間ベースのフィルタリング

Exclude パラメーター

特定の投稿タイプを結果から除外します:
cURL

ボリューム制限

各タイムラインには最大取得制限があります:
これらの制限を超えて投稿をリクエストすると、データを含まない成功レスポンスが返ります。

投稿の編集

投稿は 30 分以内に最大 5 回まで編集できます。タイムラインエンドポイントは常に最新バージョンを返します。

考慮事項

  • 30 分以上経過した投稿は最終バージョンを表します
  • ニアリアルタイムユースケースでは編集の可能性を考慮してください
  • 必要に応じて Post lookup を使用して最終状態を確認します

Edit Posts の基礎

投稿の編集について詳しく学ぶ

投稿メトリクス

公開メトリクス

App-Only または User Context 認証で、すべての投稿で利用可能:

非公開メトリクス

投稿の作成者からの User Context 認証が必要です:
  • 直近 30 日間の投稿でのみ利用可能
  • 認証ユーザーが作成した投稿でのみ返されます
  • 他のユーザーの投稿ではエラーを返します

エッジケース

30 日以上前の投稿で非公開メトリクスをリクエストする場合、result_count: 0 と共に next_token が返されることがあります。これを避けるには:
  • リクエストを直近 30 日間内に保つ
  • max_results を少なくとも 10 にする
140 文字を超えるテキストを含む Retweet では、text フィールドが切り詰められます。完全なテキストを取得するには referenced_tweets.id expansion を使用します。

次のステップ

Home timeline クイックスタート

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

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

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

API リファレンス

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

ページネーション

大規模な結果セットを処理