Saltar al contenido principal

​
Introducción

Aunque el endpoint de búsqueda reciente solo permite obtener Publicaciones de los últimos 7 días, los endpoints de cronología de Publicaciones de usuario y de cronología de menciones de usuario permiten recuperar Publicaciones y menciones anteriores a esos 7 días, para un usuario autorizado (usando el id de usuario). Los desarrolladores pueden usar estos endpoints para estudiar temas, entidades y el sentimiento de las Publicaciones en la cronología de un usuario o en sus menciones. En este tutorial, te mostraremos cómo explorar las Publicaciones y menciones de un usuario usando los endpoints de cronología de Tweets de usuario y de cronología de menciones de usuario.  

​
Requisitos previos

​
Cuenta de desarrollador aprobada

Si aún no tienes una, puedes solicitar una cuenta de desarrollador.

​
Crear un proyecto y conectar una App

En la Consola de desarrollador, haz clic en crear una nueva App.
Asígnale un nombre, selecciona el caso de uso adecuado y proporciona una descripción del proyecto. A continuación, puedes crear una nueva App o conectar una App existente (una App es un contenedor para tus claves de API que necesitas para hacer una solicitud HTTP a la X API).
Haz clic en «create a new App instead» y asigna un nombre a tu App para crear una nueva App.
Una vez que hagas clic en completar, obtendrás tus claves de API y el Bearer Token, que luego podrás usar para conectarte a los nuevos endpoints de la X API v2.
Haz clic en el (+) junto a API key, API secret key y Bearer Token y copia estos valores en un lugar seguro de tu máquina local. Los necesitarás para hacer las llamadas a la API en el siguiente paso. Nota: Las claves de la captura de pantalla anterior están ocultas, pero en tu propia Consola de desarrollador podrás ver los valores reales de la API key, API secret key y Bearer Token.  

​
Cómo obtener el id de usuario para usarlo en los endpoints de timeline de Tweets de usuario y timeline de menciones de usuario

Los endpoints de timeline de Tweets de usuario y timeline de menciones de usuario te permiten obtener Publicaciones usando el id de usuario. Para obtener el id de usuario a partir de un nombre de usuario, puedes usar el nuevo user lookup endpoint v2. Sustituye USER_NAME por el nombre de usuario que elijas y XXXX por tu propio Bearer Token que obtuviste anteriormente 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Verás el id de usuario en la respuesta, como se muestra a continuación: 
{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}

​
Conectarse a los endpoints de timeline de Tweets de usuario y timeline de menciones de usuario

Para obtener el timeline de Tweets de un usuario, ejecuta el siguiente comando curl en tu terminal (asegúrate de reemplazar USER_ID con el id del usuario que elijas y XXXX con tu propio Bearer Token que obtuviste anteriormente) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Verás que la respuesta JSON de estas solicitudes incluye el id y el texto de las Publicaciones de forma predeterminada (ejemplo a continuación). 
{
   "id": "1334200897081987072",
   "text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
Si deseas que se devuelvan campos adicionales como parte de la respuesta (como información del usuario, campos adicionales de Tweet como anotaciones de contexto, etc.), tendrás que especificar esos campos explícitamente en tu solicitud. Aprende cómo hacerlo en la guía sobre el uso de campos y expansions. También puedes obtener estas Publicaciones en el lenguaje de programación que prefieras. Consulta nuestro código de ejemplo en Python, Node (JavaScript), Java y Ruby para los endpoints user Tweet timeline y user mention timeline en nuestro repositorio de GitHub.

​
Exploración de las Publicaciones del usuario

Una vez que sepas cómo obtener Publicaciones usando los endpoints de cronología de Tweets del usuario y de cronología de menciones del usuario, puedes empezar a explorar sus Publicaciones. Por ejemplo, si quisieras identificar entidades con nombre comunes presentes en las menciones de un usuario, puedes hacer lo siguiente: En la solicitud a la API, especifica que quieres que se incluya el objeto context_annotations en las respuestas de Tweet: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
En la respuesta, podrás ver si hay entidades nombradas en las menciones. Aquí tienes un ejemplo: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marcas y compañías"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Si quieres ver qué entidades populares aparecen en tus menciones, puedes llevar un recuento de entidades populares analizando cada Tweet de las menciones. Si quieres explorar la URL de la imagen de vista previa de todas las Publicaciones de tu cronología que contienen contenido multimedia, puedes hacer lo siguiente: En la solicitud de API, especifica que quieres el preview_image_url en los campos tweet.media y las expansions attachments.media_keys 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
En la respuesta verás preview_image_url dentro del objeto includes, como se muestra a continuación: 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
Una vez que comprendas cómo navegar por las Publicaciones de un usuario, también puedes usar otras API y servicios para sacar aún más partido de esas Publicaciones. A continuación se muestran algunos recursos que conviene tener a mano al usar los endpoints de la cronología de Tweets de usuario y de la cronología de menciones de usuario.

​
Recursos