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. 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. 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.
- 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
Obtenga más información sobre cómo usar campos y expansions.
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:
Obtén más información sobre cómo usar fields y expansions.
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.
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.
- Una cuenta de desarrollador
- Una App de desarrollador creada dentro de un Project
- Claves y tokens de la App de desarrollador de ese Project
OAuth 2.0 Bearer Token es obligatorio para hacer solicitudes en nombre de tu App de desarrollador 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.
- Tweets
- Usuarios
- Listas
- Formato nativo a X API v2 (estándar v1.1)
- Native Enriched a X API v2 (enterprise)
- Activity Streams a X API v2 (enterprise)