Saltar al contenido principal

​
Introducción

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

​
Requisitos previos

​
Cuenta de desarrollador aprobada

Si aún no cuentas con una, puedes solicitarla.

​
Crear un Project y conectar una App

En el portal de desarrolladores, haz clic en crear un nuevo Project.
Asígnale un nombre, selecciona el caso de uso adecuado y proporciona una descripción del Project. A continuación, puedes crear una nueva App o conectar una App existente (una App es un contenedor para tus API keys que necesitas para realizar 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 «complete», obtendrás tus API keys y el Bearer Token que 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 en tu máquina local. Los necesitarás para realizar las llamadas a la API en el siguiente paso. Nota: Las keys en la captura de pantalla anterior están ocultas, pero en tu propio portal de desarrolladores podrás ver los valores reales para la API Key, API Secret Key y Bearer Token.  

​
Cómo obtener el id de usuario para usarlo en los endpoints de la cronología de Tweets del usuario y la cronología de menciones del usuario

Los endpoints de la cronología de Tweets del usuario y de la cronología de menciones del usuario permiten obtener Posts usando el id de usuario. Para obtener el id de usuario a partir de un nombre de usuario, puedes usar el nuevo endpoint de consulta de usuarios v2. Reemplaza USER_NAME por el nombre de usuario que elijas y XXXX por tu propio Bearer Token obtenido 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": "Desarrolladores",
       "username": "XDevelopers"
   }
}

​
Conexión a los endpoints de la cronología de Tweets del usuario y de menciones del usuario

Para obtener la cronología de Tweets de un usuario, ejecuta el siguiente comando curl en tu terminal (asegúrate de reemplazar USER_ID por el id del usuario que elijas y XXXX por tu propio Bearer Token obtenido arriba) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Verás que la respuesta JSON para estas solicitudes incluye de forma predeterminada el id y el texto de los Posts (véase el ejemplo a continuación). 
{
   "id": "1334200897081987072",
   "text": "👀 Si eres nuevo en X API v2, consulta esta guía paso a paso para realizar tu primera solicitud https://t.co/4rZqThpSbp"
}
Si desea que se devuelvan campos adicionales como parte de la respuesta (por ejemplo, información del usuario o campos adicionales de Tweet como context annotations, etc.), deberá especificar esos fields explícitamente en su solicitud. Aprenda cómo hacerlo en la guía sobre el uso de fields y expansions. También puede obtener estos Posts con el lenguaje de programación de su preferencia. Consulte nuestro Código de muestra en Python, Node (JavaScript), Java y Ruby para los endpoint de user Tweet timeline y user mention timeline en nuestro repositorio de GitHub.

​
Explorando los Posts del usuario

Una vez que sepas cómo obtener Posts usando los endpoints de la cronología de Tweets del usuario y de menciones del usuario, puedes comenzar a explorar sus Posts. 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 devuelva el objeto context_annotations en las respuestas de los Tweets: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
En la respuesta verá si hay entidades con nombre en las menciones. Aquí tienes un ejemplo: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marcas y empresas"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Si quisieras ver qué entidades populares aparecen en tus menciones, podrías llevar un conteo de ellas analizando cada Tweet en las menciones. Si quisieras explorar la URL de la imagen de vista previa de todos los Posts en tu cronología que contienen contenido multimedia, puedes hacer lo siguiente: En la solicitud a la API, especifica que quieres el preview_image_url en los tweet.media fields y las attachments.media_keys expansions 
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á preview_image_url en el 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 los Posts de un usuario, también puedes utilizar otras APIs y servicios para hacer más con esos Posts. A continuación encontrarás algunos recursos útiles para usar los endpoints de la cronología de Tweets de un usuario y de menciones del usuario.

​
Recursos

⌘I