> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

***

<div id="edit-rules">
  ## Reglas de edición
</div>

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

***

<div id="what-cant-be-edited">
  ## Lo que no se puede editar
</div>

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

***

<div id="edit-data-in-responses">
  ## Editar los datos de las respuestas
</div>

<div id="default-fields">
  ### Campos predeterminados
</div>

Todas las respuestas de publicaciones incluyen `edit_history_tweet_ids` de forma predeterminada:

```json theme={null}
{
  "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)

<div id="edit-controls">
  ### Controles de edición
</div>

Solicita `edit_controls` para recuperar el estado de edición:

```bash theme={null}
curl "https://api.x.com/2/tweets/1234567891?tweet.fields=edit_controls" \
  -H "Authorization: Bearer $TOKEN"
```

```json theme={null}
{
  "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)                 |

***

<div id="getting-edit-history">
  ## Obtener el historial de ediciones
</div>

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

```bash theme={null}
curl "https://api.x.com/2/tweets/1234567891?\
tweet.fields=edit_controls&\
expansions=edit_history_tweet_ids" \
  -H "Authorization: Bearer $TOKEN"
```

```json theme={null}
{
  "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
      }
    }]
  }
}
```

***

<div id="which-version-is-returned">
  ## ¿Qué versión se devuelve?
</div>

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:

```bash theme={null}
# 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"
```

***

<div id="metrics-for-edited-posts">
  ## Métricas de publicaciones editadas
</div>

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.

***

<div id="availability">
  ## Disponibilidad
</div>

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.

***

<div id="use-cases">
  ## Casos de uso
</div>

<Tabs>
  <Tab title="Seguimiento de cambios">
    Supervisa las publicaciones para detectar ediciones y registra las diferencias:

    ```python theme={null}
    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")
    ```
  </Tab>

  <Tab title="Mostrar indicador de edición">
    Muestra una etiqueta «Editado» en tu interfaz de usuario (IU):

    ```javascript theme={null}
    const isEdited = post.edit_history_tweet_ids?.length > 1;
    if (isEdited) {
      showEditedBadge();
    }
    ```
  </Tab>

  <Tab title="Obtener contenido original">
    Recupera la versión original de una publicación editada:

    ```python theme={null}
    original_id = post["edit_history_tweet_ids"][0]
    original = api.get_tweet(original_id)
    ```
  </Tab>
</Tabs>

***

<div id="next-steps">
  ## Próximos pasos
</div>

<CardGroup cols={2}>
  <Card title="Búsqueda de Publicaciones" icon="magnifying-glass" href="/es/x-api/posts/lookup/introduction">
    Recupera Publicaciones con historial de edición.
  </Card>

  <Card title="Diccionario de datos" icon="book" href="/es/x-api/fundamentals/data-dictionary">
    Referencia completa del objeto Publicación.
  </Card>
</CardGroup>