Saltar al contenido principal
La última versión de X API v2 es muy relevante. Por ello, hemos dividido esta sección de migración en varias partes:
Novedades de X API v2Conozca los nuevos endpoints y las funciones que hemos lanzado para 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 datosAprenda a adaptar sus analizadores de datos que antes funcionaban con Standard v1.1 y los formatos de datos de Enterprise.
Mapa de endpoints de X APIVea cómo los endpoints de Standard v1.1 y Enterprise 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 en producto y la innovación. Hemos colaborado con desarrolladores para crear la próxima generación de la X API y atender mejor a nuestra diversa comunidad de desarrolladores. A partir de sus comentarios, reconstruimos la API para responder a un conjunto más amplio de necesidades, introdujimos nuevas funciones y endpoints y mejoramos la experiencia del desarrollador. La X API v2 es ahora la API principal de X y es donde se concentran la inversión en producto y la innovación. En los últimos años, colaboramos con desarrolladores y reconstruimos la API para responder a un conjunto más amplio de necesidades, introducir nuevas funciones y endpoints y mejorar la experiencia del desarrollador. 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?

X API v2 está construida sobre una base moderna y más sostenible, e incluye endpoints de reemplazo mejorados para Standard v1.1 y productos Enterprise, además de funcionalidades totalmente nuevas. Recomendamos encarecidamente a los clientes de las API heredadas (v1.1 y Enterprise) que comiencen a migrar a v2, ya que tenemos la intención de retirarlas eventualmente. Use X API para escuchar y analizar la conversación pública, interactuar con las personas en X e innovar. En esta sección, hablaremos sobre los endpoints y la funcionalidad.

​
Endpoints de v2

Puede consultar una lista completa de los endpoints de v2 y sus equivalentes anteriores a v2 en la siguiente guía:
Si bien la mayoría de los endpoints en X API v2 sustituyen a los anteriores, hemos introducido varios endpoints nuevos. A continuación, algunos ejemplos de los nuevos endpoints que hemos lanzado en v2:
  • Endpoints de Spaces para ayudar a las personas a sacar mayor provecho de X Spaces y permitir a los desarrolladores contribuir a definir el futuro de las conversaciones de audio.
  • Ocultar respuestas, que le permite crear herramientas que ayuden a limitar el impacto de respuestas abusivas, distractoras o engañosas a escala.
  • Nuevos endpoints de Lists que le permiten anclar y desanclar Lists, o consultar las Lists ancladas de una persona.
  • Nuevos endpoints de cumplimiento por lotes que le permiten garantizar que los datos de usuario y los datos de Tweet que almacena cumplan con las normas.

​
Funcionalidad nueva

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

​
Descubra objetos de respuesta nuevos y actualizados

Los siguientes seis objetos data están disponibles con los endpoints de v2:
ObjetoDescripción
TweetEl objeto Tweet tiene una lista extensa de campos de nivel raíz, como id, text y created_at. Los objetos Tweet también son el objeto padre de varios objetos secundarios, incluidos user, media, poll y place.
UserEl objeto de usuario contiene metadata de la cuenta de usuario de X que describe al usuario de referencia.
SpacesEl objeto Space consta de campos como state, host_id, is_ticketed e incluso lang.
ListsEl objeto List contiene información básica sobre la lista solicitada, incluidos description, member_count y owner_id.
MediaSi un Tweet contiene contenido multimedia (como imágenes), se puede solicitar el objeto media con el parámetro media.fields; incluye campos como media_key, type, url, preview_image_url y más.
PollUna encuesta incluida en un Tweet no es un objeto principal en ningún endpoint, pero puede localizarse y expandirse en el objeto Tweet.
PlaceEl objeto place consta de campos como place_id, el objeto geo, country_code y más. Esta información puede usarse para identificar y analizar Tweets por ubicación.
Obtenga más información sobre cómo usar fields y expansions.

​
Flexibilidad para elegir qué objetos y fields recibe

Al realizar una solicitud a un endpoint GET, recibirá el objeto de data principal relacionado con ese endpoint, que incluirá un conjunto de fields predeterminados. Por ejemplo, el objeto Tweet proporciona los fields id y text como predeterminados. Si desea obtener fields adicionales con su solicitud, deberá usar los parámetros fields y expansions. El parámetro expansions le permite recuperar objetos de data relacionados, como el Tweet fijado de un usuario o un objeto de media, mientras que los operadores de field le permiten solicitar fields específicos dentro de los objetos devueltos más allá de los predeterminados. A continuación, se muestra una lista completa de expansions que puede solicitar con los diferentes endpoints de X API v2:
Object / ResourceAvailable Expansions
Tweetsauthor_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
Userspinned_tweet_id
Spacesinvited_user_ids, speaker_ids, creator_id, host_ids, topic_ids
Obtenga más información sobre cómo usar fields y expansions.

​
Nuevas metrics disponibles en objetos de Tweets, usuarios, Spaces y medios

Ahora hay más metrics disponibles en los objetos de Tweet, usuario, Spaces, List y medios. Estas metrics pueden ser públicas o privadas, y algunas pueden desglosarse por context orgánico o promocionado para anuncios de Tweet. Más información sobre las metrics disponibles.
ObjectAvailable MetricsPublic MetricsPrivate MetricsOrganic MetricsPromoted Metrics
tweetsretweet_count✔️✔️✔️
quote_count✔️
like_count✔️✔️✔️
reply_count✔️✔️✔️
impression_count✔️✔️✔️
url_profile_clicks✔️✔️✔️
url_link_clicks✔️✔️✔️
userfollower_count✔️
userfollowing_count✔️
mediaview_count✔️
mediaplayback_0_count✔️
spaceparticipant_count✔️

​
Editar Tweets

Los endpoints de la X API v2 proporcionan metadata 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. Desde esa fecha, los Tweets elegibles pueden editarse durante 30 minutos y hasta 5 veces. Obtén más información sobre Edit Tweets. Usando 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.
  • Los Tweets pueden editarse durante 30 minutos y hasta 5 veces. Para los Tweets editables, puedes ver si aún queda tiempo para editar 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 de Tweet).
  • Todo el historial de ediciones del Tweet.
  • La interacción atribuida a cada versión del Tweet.

​
Seguimiento de 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 de Tweet 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: Tenga en cuenta la importancia de usar keys and tokens de una App dentro de un Project. Si utiliza keys and tokens de una App fuera de un Project, 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 X API, usarás dos patrones de autenticación diferentes, Contexto de usuario de OAuth 1.0a y OAuth 2.0 Bearer Token, para acceder a distintos endpoints. Cada uno tiene un propósito diferente al realizar solicitudes a los endpoints: El Contexto de usuario de OAuth 1.0a es necesario cuando haces una solicitud en nombre de un usuario de X OAuth 2.0 Bearer Token es necesario para realizar solicitudes en nombre de tu App de desarrollador

​
Herramientas y código

Para ayudarte a empezar y familiarizarte con los nuevos endpoints y funcionalidades, contamos con varias opciones para acelerar tu trabajo:
  • Disponemos de 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 ofrecemos una lista de bibliotecas, tanto compatibles con X como de terceros, en Ruby, Python, Node, Java y muchas más. Para más contexto, consulta nuestra página de herramientas y bibliotecas.

​
Migración a los 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 y contrastar las capacidades de cada endpoint actualizado frente a versiones anteriores:

​
Migración al nuevo formato de datos

A medida que migra 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 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 le ayudarán a mapear los fields del formato de datos previo a v2 con los nuevos fields, y a describir cómo solicitar estos nuevos fields. Puede obtener más información visitando la sección de migración de formatos de datos de este hub 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 existentes de Standard v1.1 y Enterprise. 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 correlacionan los endpoints de X API con las versiones anteriores. Si deseas ver qué viene después, visita nuestra hoja de ruta del producto. También contamos con un changelog que puedes consultar para conocer lo que ya hemos lanzado.

​
¿Qué deberíamos crear a continuación?

A medida que ampliamos las capacidades de la X API v2, queremos seguir escuchándote. Agradecemos y alentamos tus sugerencias. Consulta las ideas que ya se han enviado, apoya aquellas que se ajusten a tus necesidades y ¡envía tus comentarios también!
⌘I