メインコンテンツへスキップ
X 上の投稿は、投稿後30分以内であれば最大5回まで編集できます。X API は、編集履歴とメタデータへの完全なアクセスを提供します。

​
編集ルール

ルール詳細
時間枠元のポストの投稿から 30 分以内
編集回数の上限最大 5 回まで編集可能
ID の挙動編集のたびに新しいポスト ID が割り当てられる
削除いずれかのバージョンを削除すると、チェーン全体が削除される

​
編集できないもの

一部の投稿タイプは編集できません。
  • プロモーション投稿 (広告)
  • 投票付き投稿
  • 他のユーザーへの返信 (自分のスレッド以外)
  • リポスト (引用ポストは編集可能です)
  • コミュニティ投稿
  • 共同投稿
  • 予約投稿

​
レスポンスに含まれる編集データ

​
デフォルトのフィールド

すべてのポストのレスポンスには、デフォルトで edit_history_tweet_ids が含まれます。 
{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"]
  }
}
  • ID が 1 件 = 編集履歴なし
  • 複数の ID = 編集履歴 (古いものから順)

​
編集コントロール

編集の状態を取得するには edit_controls をリクエストします。 
curl "https://api.x.com/2/tweets/1234567891?tweet.fields=edit_controls" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"],
    "edit_controls": {
      "is_edit_eligible": true,
      "editable_until": "2024-01-15T12:30:00.000Z",
      "edits_remaining": 3
    }
  }
}
FieldDescription
is_edit_eligibleポストを編集できるかどうか
editable_until編集ウィンドウが閉じる時刻のタイムスタンプ
edits_remaining残りの編集可能回数 (0〜5)

​
編集履歴の取得

すべてのバージョンの完全なポストオブジェクトを取得するには、edit_history_tweet_ids のexpansion (拡張) を使用します。 
curl "https://api.x.com/2/tweets/1234567891?\
tweet.fields=edit_controls&\
expansions=edit_history_tweet_ids" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"],
    "edit_controls": {
      "is_edit_eligible": true,
      "editable_until": "2024-01-15T12:30:00.000Z",
      "edits_remaining": 3
    }
  },
  "includes": {
    "tweets": [{
      "id": "1234567890",
      "text": "Original text (with typo)",
      "edit_history_tweet_ids": ["1234567890", "1234567891"],
      "edit_controls": {
        "is_edit_eligible": true,
        "editable_until": "2024-01-15T12:30:00.000Z",
        "edits_remaining": 3
      }
    }]
  }
}

​
どのバージョンが返されますか？

デフォルトでは、APIは編集済みポストの最新バージョンを返します。 特定のバージョンを取得するには、そのポストのIDを指定して直接リクエストしてください。 
# オリジナルバージョンを取得
curl "https://api.x.com/2/tweets/1234567890" -H "Authorization: Bearer $TOKEN"

# 編集済みバージョンを取得  
curl "https://api.x.com/2/tweets/1234567891" -H "Authorization: Bearer $TOKEN"

​
編集済み投稿の指標

編集済み投稿の各バージョンには、それぞれ個別のエンゲージメント指標があります。これらの指標は、エンゲージメントが発生した時点で表示されていたバージョンに紐づきます。

​
提供状況

編集メタデータは次の対象で利用できます：
  • 2022年9月29日以降に作成されたすべての投稿
  • 投稿を返すすべてのv2エンドポイント
  • 検索、タイムライン、ストリーム、ルックアップを含む
この日付より前に作成された投稿には編集メタデータは付与されません。

​
ユースケース

投稿の編集を監視し、差分をログに記録します。
def check_for_edits(post):
    history = post.get("edit_history_tweet_ids", [])
    if len(history) > 1:
        print(f"Post {post['id']} has been edited {len(history) - 1} times")

​
次のステップ

ポストルックアップ

編集履歴付きの投稿を取得します。

データ辞書

ポストオブジェクトの完全なリファレンス。