Resumen

La última versión de X API v2 es muy importante. Por ello, hemos dividido esta sección de migración en varias partes:

Novedades de X API v2	Conozca los nuevos endpoints y las funcionalidades que hemos lanzado en X API v2.
¿Listo para migrar?	Comience su migración con un conjunto de guías e instrucciones.
Guía de migración del formato de data	Aprenda cómo adaptar sus parsers de data que anteriormente funcionaban con el estándar v1.1 y los formatos de data Empresarial.
Mapa de endpoints de X API	Vea cómo los endpoints estándar v1.1 y Empresarial se corresponden con los nuevos endpoints de X API v2.

---

​

¿Qué es la X API v2?

La X API v2 es ahora la API principal de X y es donde se concentran la inversión y la innovación de producto. Nos hemos asociado con desarrolladores para crear la próxima generación de la X API y servir mejor a nuestra diversa comunidad de desarrolladores. A partir de los comentarios de la comunidad, hemos rediseñado la API para atender un conjunto más amplio de necesidades, incorporado nuevas funciones y endpoints, y mejorado la experiencia para desarrolladores.

La X API v2 es ahora la API principal de X y es donde se concentran la inversión y la innovación de producto. En los últimos años, nos hemos asociado con desarrolladores y hemos rediseñado la API para atender un conjunto más amplio de necesidades, incorporar 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 creen con la X API v2.

​

¿Por qué migrar?

La X API v2 está desarrollada sobre una base moderna y más sostenible e incluye tanto endpoints de reemplazo mejorados para la v1.1 estándar y productos Empresariales, como también funcionalidades completamente nuevas. Recomendamos encarecidamente que los clientes de las API heredadas (v1.1 y Empresarial) comiencen a migrar a v2, ya que tenemos la intención de retirarlas eventualmente. Use 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 la funcionalidad.

​

Endpoints de v2

Puedes ver una lista completa de los endpoints de v2 y sus equivalentes anteriores a v2 en la siguiente guía:

Mapa de endpoints de la X API

Si bien la mayoría de los endpoints de X API v2 sustituyen a otros anteriores, hemos introducido varios 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 dar forma al futuro de las conversaciones de audio.
• Ocultar respuestas, que te permite crear herramientas que ayuden a limitar a escala el impacto de respuestas abusivas, distractoras o engañosas.
• Nuevos endpoints de Listas que te permiten fijar y desafijar Listas o consultar las Listas fijadas de alguien.
• Nuevos endpoints de cumplimiento por lotes que te permiten garantizar que tus datos de usuario y de Tweet almacenados cumplan con las normas.

​

Nueva funcionalidad

X API v2 también incluye nuevas funciones que le ayudarán a obtener más valor con la X API. Gran parte de las novedades se ha impulsado gracias a sus comentarios e incluye ciertas funciones que antes estaban reservadas a clientes Empresariales.

Algunas de las mejoras de la API incluyen:

• Un diseño coherente en todos los endpoints
• La capacidad de especificar qué fields y objetos se devuelven en el payload de la respuesta
• Nuevos objetos de data más detallados
• Recibir y filtrar data con nueva información contextual impulsada por 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 data para investigadores académicos
• Funcionalidad de recuperación y redundancia para endpoints de streaming
• Devolver fácilmente recuentos de Tweets que coinciden con una consulta
• Compatibilidad con Edit Tweets
• Filtrado de spam con alta fiabilidad
• Las URL acortadas se expanden completamente para un filtrado y análisis más eficaces
• Objetos de respuesta JSON simplificados al eliminar fields obsoletos y modernizar etiquetas
• Devolución del 100% de los Tweets públicos y disponibles que coincidan en consultas de búsqueda
• Reglas de streaming para poder realizar cambios sin interrumpir las conexiones
• Lenguaje de consulta más expresivo para la búsqueda de Tweets, recuentos de Tweets y flujo filtrado
• Especificación OpenAPI para crear nuevas bibliotecas y hacer un seguimiento de los cambios con mayor transparencia

​

Descubra objetos de respuesta nuevos y actualizados

Los siguientes seis objetos de data están disponibles con los endpoints v2:

Object	Description
Tweet	El objeto Tweet tiene una larga lista de fields a nivel raíz, como id, text y created_at. Los objetos Tweet también son el objeto principal de varios objetos secundarios, incluidos user, media, poll y place.
User	El objeto user contiene metadatos de la cuenta de X que describen al usuario de referencia.
Spaces	El objeto Space consta de fields como state, host_id, is_ticketed e incluso lang.
Lists	El objeto List contiene información básica sobre la lista solicitada, incluidos description, member_count y owner_id.
Media	Si un Tweet contiene media (como imágenes), entonces el objeto media se puede solicitar usando el parámetro media.fields e incluye fields como media_key, type, url, preview_image_url y más.
Poll	Una encuesta incluida en un Tweet no es un objeto principal en ningún endpoint, pero se puede encontrar y expandir en el objeto Tweet.
Place	El objeto place consta de fields como place_id, el objeto geo, country_code y más. Esta información se puede usar para identificar Tweets y analizarlos por ubicación.

Obtenga más información sobre cómo usar fields y expansions.

​

Flexibilidad para elegir qué objetos y fields recibes

Al realizar una solicitud a un endpoint GET, recibirás el objeto principal de data relacionado con ese endpoint, que incluirá un conjunto de fields predeterminados. Por ejemplo, el objeto Tweet entrega los fields id y text como predeterminados.

Si deseas obtener fields adicionales con tu solicitud, deberás usar los parámetros fields y expansions. El parámetro expansions te permite obtener objetos de data relacionados, como el Tweet fijado de un usuario o un objeto de media, mientras que los operadores de field te permiten solicitar fields específicos dentro de los objetos devueltos más allá de los predeterminados.

Aquí tienes una lista completa de expansions que puedes solicitar con los diferentes endpoints de X API v2:

Objeto / Recurso	Expansions disponibles
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 disponibles en los objetos de Tweet, usuario, Spaces, Listas y medios. Estas métricas incluyen datos públicos y privados, y algunas pueden desglosarse por contexto orgánico o promocionado para anuncios de Tweet.

Obtén más información sobre las métricas disponibles.

Objeto	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 los que incluyen encuestas o los programados, no se pueden editar.
• Que los Tweets son editables durante 30 minutos y hasta 5 veces. En los Tweets editables puedes ver si aún queda tiempo para editar y cuántas ediciones más 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 mediante el id del Tweet).
• Todo el historial de ediciones del Tweet.
• La interacción atribuida a cada versión del Tweet.

​

Realiza un seguimiento de las conversaciones en hilo

Un nuevo campo de Tweet 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 usar los endpoints de v2, necesitará lo siguiente:

• Una cuenta de desarrollador
• Una App de desarrollador creada dentro de un Proyecto
• Claves y tokens de la App de desarrollador de ese Proyecto

Tenga en cuenta la importancia de usar claves y tokens de una App dentro de un Proyecto. Si utiliza claves y tokens de una App fuera de un Proyecto, no podrá realizar solicitudes a los endpoints de v2.

Una vez que tenga una cuenta de desarrollador, puede configurar todo lo anterior en el Portal de desarrolladores.

​

Autenticación

Con la nueva Twitter API, usarás dos patrones de autenticación diferentes, Contexto de usuario de OAuth 1.0a y token de portador (Bearer) de OAuth 2.0, para acceder a distintos endpoints. Cada uno cumple un propósito diferente al realizar solicitudes a los endpoints:

El Contexto de usuario de OAuth 1.0a es requerido cuando haces una solicitud en nombre de un usuario de Twitter El token de portador (Bearer) de OAuth 2.0 es requerido para realizar solicitudes en nombre de tu App de desarrollador

​

Herramientas y código

Para ayudarte a comenzar y familiarizarte con los nuevos endpoints y funcionalidades, contamos con varias opciones para acelerar tu trabajo:

• Tenemos una colección de Postman de X que te permite usar el cliente Postman para realizar solicitudes y conectarte a endpoints individuales. Es una forma sencilla de probar la Autenticación y experimentar con los endpoints.
• También hemos incluido una lista de bibliotecas compatibles con X y de terceros en Ruby, Python, Node, Java y muchos más. Para obtener más contexto, consulta nuestra página de herramientas y bibliotecas.

​

Migración a endpoints actualizados

A medida que comienzas a explorar los nuevos endpoints de X v2, hemos creado una serie de guías de migración detalladas para ayudarte a comparar las capacidades de cada endpoint actualizado con respecto a las versiones anteriores:

• Tweets
  • Consulta de Tweets
  • Administrar Tweets
  • Cronologías
  • Buscar Tweets
  • Conteo de Tweets
  • Flujo filtrado
  • Flujo muestreado
  • Retweets
  • Me gusta
  • Ocultar respuestas
• Usuarios
  • Consulta de usuarios
  • Follows
  • Bloqueos
  • Silencios
• Listas
  • Consulta de listas
  • Administrar listas
  • Consulta de Tweets de la lista
  • Miembros de la lista

​

Migración al nuevo formato de datos

Al pasar de v1.1 o Empresarial a v2, es importante entender que el formato en el que se entregan los datos ha cambiado significativamente. Hemos añadido nuevos fields, modificado la secuencia de fields 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 mapear los fields del formato de datos previo a v2 a los fields más recientes y describirán cómo solicitar estos nuevos fields.

Puedes obtener más información visitando la sección de migración de formatos de datos de este centro de migración o consultando nuestras guías específicas sobre formatos de datos:

• Formato nativo a X API v2 (estándar v1.1)
• Native Enriched a X API v2 (Empresarial)
• Activity Streams a X API v2 (Empresarial)

​

¿Qué sigue?

Quienes han utilizado 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 empresariales existentes. De hecho, nuestra intención es que estos reemplacen las tres versiones en el futuro.

Hemos preparado una tabla para ayudarle a comprender cómo se relacionan los endpoints de la X API con las versiones anteriores.

Si desea conocer lo que viene a continuación, visite nuestra hoja de ruta del producto.

También contamos con un registro de cambios que puede consultar para conocer lo que ya hemos lanzado.

​

¿Qué deberíamos construir a continuación?

A medida que incorporamos capacidades adicionales a la X API v2, queremos seguir escuchándote. Agradecemos y te animamos a que nos envíes tus comentarios.

Consulta las ideas que ya se han enviado, apoya aquellas que se alineen con tus necesidades y envíanos también tus comentarios.