認証
エンドポイントの要件
非公開メトリクス
非公開メトリクスにアクセスするには、投稿の作成者の代理で認証する必要があります:Fields と expansions
デフォルトでは、レスポンスにid、text、edit_history_tweet_ids のみが含まれます。追加データをリクエストします:
リクエスト例
cURL
主なフィールド
Fields と expansions ガイド
レスポンスのカスタマイズについて詳しく学ぶ
ページネーション
タイムラインはリクエストあたり最大 100 投稿を返します。より大規模な結果セットにはページネーションを使用します。しくみ
max_resultsを指定して最初のリクエストを行うmetaオブジェクトからnext_tokenを取得- 次のリクエストに
pagination_tokenを含める 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 にする
非プロモート投稿の promoted metrics
非プロモート投稿の promoted metrics
プロモートされていない投稿に対して promoted metrics をリクエストすると、空のレスポンスが返されます。これは既知の問題です。
切り詰められた Retweet テキスト
切り詰められた Retweet テキスト
140 文字を超えるテキストを含む Retweet では、text フィールドが切り詰められます。完全なテキストを取得するには
referenced_tweets.id expansion を使用します。次のステップ
Home timeline クイックスタート
ユーザーのホームフィードを取得
メンション クイックスタート
ユーザーのメンションを取得
API リファレンス
エンドポイントの完全なドキュメント
ページネーション
大規模な結果セットを処理