Descripción general

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 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, 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, o consultar las Listas ancladas de alguien.
Nuevos endpoints de cumplimiento por lotes 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
La capacidad de especificar qué campos y objetos se devuelven en el payload de la respuesta
Objetos de datos nuevos y más detallados
Recibir y filtrar datos con nueva información contextual basada en anotaciones de Tweet
Acceso a nuevas métricas
Identificar y filtrar fácilmente las conversaciones que pertenecen a un hilo de respuestas
Funcionalidad avanzada y mayor acceso a datos para investigadores académicos
Funcionalidad de recuperación y redundancia para endpoints de streaming
Obtener fácilmente el recuento de Tweets que coinciden con una consulta
Compatibilidad con Edit Tweets
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	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	El objeto User contiene metadatos de la cuenta de usuario de X que describen al usuario de referencia.
Spaces	El objeto Space consta de campos como `state`, `host_id`, `is_ticketed` e incluso `lang`.
Lists	El objeto List contiene información básica sobre la lista solicitada, incluida `description`, `member_count` y `owner_id`.
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	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	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.

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

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

Listo para migrar

Para poder usar los endpoints de v2, necesitarás lo siguiente:

Una cuenta de desarrollador
Una App de desarrollador creada dentro de un Project
Claves y tokens 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.

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

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
- Administrar Tweets
- Cronologías
- Buscar Tweets
- Recuento de Tweets
- Flujo filtrado
- Flujo muestreado
- Retweets
- Me gusta
- Ocultar respuestas
Usuarios
Listas

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 de este centro de migración, o consultando nuestras guías específicas de formato de datos:

¿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 y enterprise 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 con las versiones anteriores. Si quieres ver qué viene después, visita nuestra hoja de ruta de producto. También contamos con un registro de cambios 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. Consulta las ideas que ya se han enviado, apoya aquellas que se ajusten a tus necesidades y déjanos también tus comentarios.