> ## 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. # Descripción general export const Button = ({href, children}) => { return
; }; La versión más reciente de X API v2 representa un gran cambio. Por ello, hemos dividido esta sección de migración en varias partes: | Novedades de X API v2 | Conozca los nuevos endpoints y la funcionalidad que hemos incorporado a X API v2. | | :------------------------------------ | :------------------------------------------------------------------------------------------------------------------------- | | ¿Listo para migrar? | Empiece su migración con este conjunto de guías e instrucciones. | | Guía de migración de formato de datos | Aprenda a adaptar sus analizadores de datos que antes funcionaban con los formatos de datos estándar de v1.1 y Enterprise. | | Mapa de endpoints de X API | Vea cómo los endpoints estándar de v1.1 y Enterprise se asignan a los nuevos endpoints de X API v2. | ***
## ¿Qué es la X API v2?
La X API v2 es ahora la X API principal y es donde se centran la inversión en producto y la innovación. Hemos colaborado con desarrolladores para crear la próxima generación de la X API y servir mejor a nuestra diversa comunidad de desarrolladores. Basándonos en los comentarios de los desarrolladores, hemos reconstruido la API para atender mejor una gama más amplia de necesidades, hemos introducido nuevas funciones y endpoints y hemos mejorado la experiencia para desarrolladores. La X API v2 es ahora la X API principal y es donde se centran la inversión en producto y la innovación. En los últimos años, hemos colaborado con desarrolladores y hemos reconstruido la API para atender mejor una gama más amplia de necesidades, introducir nuevas funciones y endpoints y mejorar la experiencia para desarrolladores. Estamos comprometidos a seguir construyendo una plataforma abierta para desarrolladores y nos entusiasma ver lo que crearás con la X API v2.
## ¿Por qué migrar?
La X API v2 se ha construido sobre una base moderna y más sostenible e incluye tanto endpoints de reemplazo mejorados para la API estándar v1.1 y los productos empresariales como funcionalidad totalmente nueva. Recomendamos encarecidamente a los clientes de las API heredadas (v1.1 y empresariales) que comiencen a migrar a v2, ya que nuestra intención es descontinuarlas eventualmente. Usa la X API para escuchar y analizar la conversación pública, interactuar con las personas en X e innovar. En esta sección, analizaremos los endpoints y su funcionalidad.
## Endpoints v2
Puedes ver una lista completa de los endpoints v2 y sus equivalentes anteriores a v2 en la siguiente guía: Aunque la mayoría de los endpoints en X API v2 son reemplazos, hemos introducido varios endpoints nuevos. Estos son algunos ejemplos de endpoints nuevos que hemos lanzado en v2: * [Endpoints de Spaces](/es/x-api/spaces/introduction) para ayudar a las personas a sacar más provecho de X Spaces y permitir que los desarrolladores contribuyan a definir el futuro de las conversaciones de audio. * [Ocultar respuestas](/es/x-api/posts/hide-replies/introduction), que te permite crear herramientas que ayudan a limitar el impacto de respuestas abusivas, que distraen o engañosas a gran escala. * Nuevos endpoints de Listas que te permiten [anclar y desanclar Listas](/es/x-api/lists/pinned-lists/introduction), o consultar las Listas ancladas de alguien. * Nuevos [endpoints de cumplimiento por lotes](/es/x-api/compliance/batch-compliance/introduction) que te permiten asegurarte de que tus datos de usuario y de Tweet almacenados cumplan la normativa vigente.
## Nueva funcionalidad
X API v2 también incluye nuevas características que te ayudarán a obtener más valor de X API. Gran parte de las novedades se ha impulsado con tus comentarios e incluye ciertas funciones que antes estaban reservadas para clientes empresariales. Algunas de las mejoras de la API incluyen: * [Un diseño coherente entre endpoints](/es/x-api/fundamentals/consistency) * [La capacidad de especificar qué campos y objetos se devuelven en el payload de la respuesta](/es/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions) * [Objetos de datos nuevos y más detallados](/es/x-api/fundamentals/data-dictionary) * [Recibir y filtrar datos con nueva información contextual basada en anotaciones de Tweet](/es/x-api/fundamentals/post-annotations) * [Acceso a nuevas métricas](/es/x-api/fundamentals/metrics) * [Identificar y filtrar fácilmente las conversaciones que pertenecen a un hilo de respuestas](/es/x-api/fundamentals/conversation-id) * [Funcionalidad avanzada y mayor acceso a datos para investigadores académicos](https://developer.x.com/content/developer-twitter/en/products/twitter-api/academic-research) * [Funcionalidad de recuperación y redundancia para endpoints de streaming](/es/x-api/posts/filtered-stream/integrate/recovery-and-redundancy-features) * [Obtener fácilmente el recuento de Tweets que coinciden con una consulta](/es/x-api/posts/counts/introduction) * [Compatibilidad con Edit Tweets](/es/x-api/fundamentals/edit-posts) * Filtrado de spam de alta confianza * Las URL acortadas se expanden por completo para un filtrado y análisis más efectivos * Objetos JSON de respuesta simplificados mediante la eliminación de campos obsoletos y la actualización de etiquetas * Devolución del 100 % de los Tweets públicos y disponibles que coinciden en las consultas de búsqueda * "Reglas" de streaming para que puedas hacer cambios sin perder conexiones * Lenguaje de consulta más expresivo para la búsqueda de Tweets, recuentos de Tweets y stream filtrado * Especificación OpenAPI para crear nuevas bibliotecas y hacer un seguimiento de los cambios de forma más transparente
### Descubra objetos de respuesta nuevos y actualizados
Los siguientes seis objetos de datos están disponibles con los endpoints v2: | Objeto | Descripción | | :----------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Tweet](/es/x-api/fundamentals/data-dictionary#tweet) | El objeto Tweet tiene una larga lista de campos de nivel raíz, como `id`, `text` y `created_at`. Los objetos Tweet también son el objeto padre de varios objetos hijo, incluidos `user`, `media`, `poll` y `place`. | | [User](/es/x-api/fundamentals/data-dictionary#user) | El objeto User contiene metadatos de la cuenta de usuario de X que describen al usuario de referencia. | | [Spaces](/es/x-api/fundamentals/data-dictionary#space) | El objeto Space consta de campos como `state`, `host_id`, `is_ticketed` e incluso `lang`. | | [Lists](/es/x-api/fundamentals/data-dictionary#list) | El objeto List contiene información básica sobre la lista solicitada, incluida `description`, `member_count` y `owner_id`. | | [Media](/es/x-api/fundamentals/data-dictionary#media) | Si un Tweet contiene contenido multimedia (como imágenes), entonces el objeto Media se puede solicitar usando el parámetro `media.fields` e incluye campos como `media_key`, `type`, `url`, `preview_image_url` y más. | | [Poll](/es/x-api/fundamentals/data-dictionary#poll) | Una encuesta incluida en un Tweet no es un objeto primario en ningún endpoint, pero se puede encontrar mediante expansión en el objeto Tweet. | | [Place](/es/x-api/fundamentals/data-dictionary#place) | El objeto Place consta de campos como `place_id`, el objeto `geo`, `country_code` y más. Esta información se puede usar para identificar Tweets y analizarlos según su ubicación. | Obtenga más información sobre [cómo usar campos y expansions](/es/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions).
### Flexibilidad para elegir qué objetos y campos recibes
Al realizar una solicitud GET a un endpoint, recibirás el objeto de datos principal asociado a ese endpoint, que incluirá un conjunto de campos predeterminados. Por ejemplo, el objeto Tweet incluye los campos `id` y `text` como predeterminados. Si quieres recuperar campos adicionales con tu solicitud, tendrás que usar los parámetros [fields](/es/x-api/fundamentals/fields) y [expansions](/es/x-api/fundamentals/expansions). El parámetro expansions te permite recuperar objetos de datos relacionados, como el Tweet fijado de un usuario o un objeto multimedia, mientras que los parámetros de campos te permiten solicitar campos específicos dentro de los objetos devueltos más allá de los predeterminados. Aquí tienes una lista completa de las expansions que puedes solicitar con los distintos endpoints de X API v2: | Object / Resource | Available Expansions | | :---------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Tweets | `author_id`, `edit_history_tweet_ids`, `entities.mentions.username`, `in_reply_to_user_id`, `referenced_tweets.id`, `referenced_tweets.id.author_id`, `attachments.poll_ids`, `attachments.media_keys`, `geo.place_id` | | Users | `pinned_tweet_id` | | Spaces | `invited_user_ids`, `speaker_ids`, `creator_id`, `host_ids`, `topic_ids` | Obtén más información sobre [cómo usar fields y expansions](/es/x-api/fundamentals/data-dictionary#how-to-use-fields-and-expansions).
## Nuevas métricas disponibles en Tweets, usuarios, Spaces y objetos de medios
Ahora hay más métricas accesibles en Tweets, usuarios, Spaces, Listas y objetos de medios. Estas métricas pueden ser públicas o privadas, y algunas se pueden desglosar en un contexto orgánico o promocionado para anuncios de Tweets. Obtén más información sobre las [métricas](/es/x-api/fundamentals/metrics) disponibles. | Object | Métricas disponibles | Métricas públicas | Métricas privadas | Métricas orgánicas | Métricas promocionadas | | :----- | :------------------- | :---------------- | :---------------- | :----------------- | :--------------------- | | tweets | retweet\_count | ✔️ | | ✔️ | ✔️ | | | quote\_count | ✔️ | | | | | | like\_count | ✔️ | | ✔️ | ✔️ | | | reply\_count | ✔️ | | ✔️ | ✔️ | | | impression\_count | | ✔️ | ✔️ | ✔️ | | | url\_profile\_clicks | | ✔️ | ✔️ | ✔️ | | | url\_link\_clicks | | ✔️ | ✔️ | ✔️ | | user | follower\_count | ✔️ | | | | | user | following\_count | ✔️ | | | | | media | view\_count | | ✔️ | | | | media | playback\_0\_count | | ✔️ | | | | space | participant\_count | ✔️ | | | |
## Editar Tweets
Los endpoints de la X API v2 proporcionan metadatos de Tweets editados. La función *Edit Tweet* se introdujo por primera vez para pruebas entre empleados de X el 1 de septiembre de 2022. A partir de esa fecha, los Tweets elegibles se pueden editar durante 30 minutos y hasta 5 veces. Obtén más información sobre [Edit Tweets](/es/x-api/fundamentals/edit-posts). Con la X API v2, un desarrollador puede determinar: * Si un Tweet era elegible para edición en el momento de su creación. Algunos Tweets, como aquellos con encuestas o Tweets programados, no se pueden editar. * Que los Tweets se pueden editar durante 30 minutos y hasta 5 veces. Para los Tweets editables, puedes ver si todavía queda tiempo para editarlos y cuántas ediciones adicionales son posibles. * Si estás viendo una versión editada de un Tweet (en la mayoría de los casos, la API devolverá la versión más reciente de un Tweet, a menos que se solicite una versión anterior específica por id del Tweet). * Todo el historial de edición del Tweet. * Las interacciones atribuidas a cada versión del Tweet.
## Hacer seguimiento de conversaciones en hilo
Un nuevo campo de Tweet te ayuda a identificar a qué hilo de conversación pertenece un Tweet. Un ID de conversación es el ID del Tweet que inició la conversación. Obtén más información sobre el [seguimiento de conversaciones](/es/x-api/fundamentals/conversation-id).
## Listo para migrar
Para poder usar los endpoints de v2, necesitarás lo siguiente: * [Una cuenta de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info) * [Una App de desarrollador](https://developer.x.com/en/apps) creada dentro de un [Project](resources/fundamentals/projects) * [Claves y tokens](resources/fundamentals/authentication) de la App de desarrollador de ese Project Ten en cuenta que es importante usar claves y tokens de una App dentro de un Project. Si usas claves y tokens de una App fuera de un Project, no podrás realizar solicitudes a los endpoints de v2. Una vez que tengas una cuenta de desarrollador, puedes configurar todo lo anterior en la [Consola de desarrollador](https://developer.x.com/en/portal/petition/essential/basic-info).
### Autenticación
Con la nueva Twitter API, utilizarás dos patrones de autenticación diferentes, OAuth 1.0a User Context y OAuth 2.0 Bearer Token, para acceder a distintos endpoints. Cada uno cumple una función diferente al realizar solicitudes a los endpoints: OAuth 1.0a User Context es obligatorio cuando haces una solicitud en nombre de un usuario de Twitter\ OAuth 2.0 Bearer Token es obligatorio para hacer solicitudes en nombre de tu App de desarrollador
## Herramientas y código
Para ayudarte a comenzar y familiarizarte con los nuevos endpoints y capacidades, tenemos algunas opciones para poner en marcha tu trabajo: * Tenemos una [colección de Postman](https://app.getpostman.com/run-collection/9956214-784efcda-ed4c-4491-a4c0-a26470a67400) de Twitter que te permite usar el cliente Postman para realizar solicitudes y conectarte a endpoints individuales. Esta es una forma sencilla de probar la autenticación y experimentar con los endpoints. * También hemos proporcionado una lista de bibliotecas, tanto compatibles con Twitter como de terceros, en Ruby, Python, Node, Java y muchos más. Para obtener más contexto, consulta nuestra [página de herramientas y bibliotecas](/es/x-api/tools-and-libraries/overview).
## Migrar a endpoints actualizados
A medida que comienzas a explorar los nuevos endpoints de Twitter v2, hemos creado una serie de guías de migración detalladas para ayudarte a comparar las capacidades de cada endpoint actualizado con las de las versiones anteriores: * **Tweets** * [Búsqueda de Tweets](/es/x-api/posts/lookup/integrate) * [Administrar Tweets](/es/x-api/posts/manage-tweets/migrate/overview) * [Cronologías](/es/x-api/posts/timelines/migrate/overview) * [Buscar Tweets](/es/x-api/posts/search/migrate/overview) * [Recuento de Tweets](/es/x-api/posts/counts/migrate/overview) * [Flujo filtrado](/es/x-api/posts/filtered-stream/migrate/overview) * Flujo muestreado * [Retweets](/es/x-api/posts/retweets/migrate/overview) * [Me gusta](/es/x-api/posts/likes/migrate/likes-lookup-standard-to-twitter-api-v2) * [Ocultar respuestas](/es/x-api/posts/hide-replies/migrate) * **Usuarios** * [Búsqueda de usuarios](/es/x-api/users/lookup/migrate/overview) * [Seguimientos](/es/x-api/users/follows/migrate/standard-to-twitter-api-v2) * [Bloqueos](/es/x-api/users/blocks/migrate) * [Silenciamientos](/es/x-api/users/mutes/migrate/manage-mutes-standard-to-twitter-api-v2) * **Listas** * [Búsqueda de Lista](/es/x-api/lists/list-lookup/migrate/overview) * [Administrar Listas](/es/x-api/lists/manage-lists/migrate/overview) * [Búsqueda de Tweets de una Lista](/es/x-api/lists/list-tweets/migrate/overview) * [Miembros de una Lista](/es/x-api/lists/list-members/migrate/overview)
## Migración al nuevo formato de datos
A medida que pases de v1.1 o enterprise a v2, es importante entender que el formato en el que se entregan los datos ha cambiado significativamente. Hemos añadido nuevos campos, modificado la secuencia de campos y, en algunos casos, eliminado elementos por completo. Para obtener más información sobre estos cambios, estamos desarrollando una serie de guías que te ayudarán a relacionar los campos del formato de datos previo a v2 con los campos más recientes, y describirán cómo solicitar estos nuevos campos. Puedes obtener más información visitando nuestra sección de [migración de formatos de datos](/es/x-api/migrate/data-format-migration) de este centro de migración, o consultando nuestras guías específicas de formato de datos: * [Formato nativo a X API v2 (estándar v1.1)](/es/x-api/migrate/data-format-migration#migrating-from-standard-v1-1s-data-format-to-v2) * [Native Enriched a X API v2 (enterprise)](/es/x-api/migrate/data-format-migration#migrating-from-native-enriched-data-format-to-v2) * [Activity Streams a X API v2 (enterprise)](/es/x-api/migrate/data-format-migration#migrating-from-activity-streams-data-format-to-v2)
## ¿Qué sigue?
Quienes hayan usado la plataforma durante algún tiempo notarán que muchos de los nuevos endpoints están alineados con los endpoints [estándar v1.1](https://developer.x.com/en/docs/twitter-api/v1) y [enterprise](/es/x-api/enterprise-gnip-2.0/enterprise-gnip) existentes. De hecho, nuestra intención es que estos reemplacen las tres versiones en el futuro. Hemos preparado una tabla para ayudarte a entender cómo [se corresponden los endpoints de X API](/es/x-api/migrate/x-api-endpoint-map) con las versiones anteriores. Si quieres ver qué viene después, visita nuestra [hoja de ruta de producto](https://trello.com/b/myf7rKwV/twitter-developer-platform-roadmap). También contamos con un [registro de cambios](https://developer.x.com/en/updates/changelog) que puedes consultar para conocer lo que ya hemos lanzado.
### ¿Qué deberíamos construir a continuación?
A medida que desarrollamos funcionalidades adicionales de X API v2, queremos seguir escuchando tus opiniones. Agradecemos y fomentamos que nos envíes tus [comentarios](https://twitterdevfeedback.uservoice.com/). Consulta las ideas que ya se han enviado, apoya aquellas que se ajusten a tus necesidades y déjanos también tus comentarios.