Editar publicaciones

Trabajar con publicaciones editadas en la X API

Las publicaciones en X pueden editarse durante los 30 minutos siguientes a su publicación, hasta 5 veces. La X API ofrece acceso completo al historial de ediciones y a los metadatos.

---

Reglas de edición

Regla	Detalles
Ventana de tiempo	30 minutos desde la publicación original
Límite de ediciones	Máximo de 5 ediciones
Comportamiento del id	Cada edición genera un nuevo id de la publicación
Eliminación	Eliminar cualquier versión elimina toda la cadena

---

Lo que no se puede editar

Algunos tipos de Publicaciones no se pueden editar:

• Publicaciones promocionadas (anuncios)
• Publicaciones con encuestas
• Respuestas a otras personas (fuera de tu propio hilo)
• Reposts (las Publicaciones citadas sí se pueden editar)
• Publicaciones de Comunidades
• Publicaciones colaborativas
• Publicaciones programadas

---

Editar los datos de las respuestas

Campos predeterminados

Todas las respuestas de publicaciones incluyen edit_history_tweet_ids de forma predeterminada:

{
  "data": {
    "id": "1234567891",
    "text": "Updated text (edited)",
    "edit_history_tweet_ids": ["1234567890", "1234567891"]
  }
}

• Una sola ID = nunca se ha editado
• Varias ID = historial de ediciones (de la más antigua a la más reciente)

Controles de edición

Solicita edit_controls para recuperar el estado de edición:

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
    }
  }
}

Field	Description
is_edit_eligible	Indica si la Publicación puede editarse
editable_until	Fecha y hora en que se cierra la ventana de edición
edits_remaining	Número de ediciones restantes (0-5)

---

Obtener el historial de ediciones

Usa la expansión edit_history_tweet_ids para obtener los objetos de Publicación completos de todas las versiones:

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
      }
    }]
  }
}

---

¿Qué versión se devuelve?

De forma predeterminada, la API devuelve la versión más reciente de una publicación editada.

Para obtener una versión específica, solicítala directamente usando el id de la publicación:

# Obtener versión original
curl "https://api.x.com/2/tweets/1234567890" -H "Authorization: Bearer $TOKEN"

# Get edited version  
curl "https://api.x.com/2/tweets/1234567891" -H "Authorization: Bearer $TOKEN"

---

Métricas de publicaciones editadas

Cada versión de una publicación editada tiene sus propias métricas de interacción. Las métricas se asignan a la versión que estaba visible cuando se produjo la interacción.

---

Disponibilidad

Los metadatos de edición están disponibles:

• Para todas las Publicaciones creadas a partir del 29 de septiembre de 2022
• En todos los endpoints v2 que devuelven Publicaciones
• Incluyendo búsqueda, timelines, stream y lookup

Las Publicaciones creadas antes de esta fecha no tienen metadatos de edición.

---

Casos de uso

Seguimiento de cambios

Supervisa las publicaciones para detectar ediciones y registra las diferencias:

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")

Mostrar indicador de edición

Muestra una etiqueta «Editado» en tu interfaz de usuario (IU):

const isEdited = post.edit_history_tweet_ids?.length > 1;
if (isEdited) {
  showEditedBadge();
}

Obtener contenido original

Recupera la versión original de una publicación editada:

original_id = post["edit_history_tweet_ids"][0]
original = api.get_tweet(original_id)

---

Próximos pasos

Búsqueda de Publicaciones

Recupera Publicaciones con historial de edición.

Diccionario de datos

Referencia completa del objeto Publicación.