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 menciones de usuario permiten recuperar Posts y menciones anteriores a ese período, para un usuario autorizado (mediante 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 en las menciones de un usuario. En este tutorial, te 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 tienes una, puedes solicitar una.

​
Crea un Project y conecta 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 App nueva o conectar una App existente (una App es un contenedor para tus claves de API que necesitas para realizar una solicitud HTTP a la X API).
Haz clic en «crear una App nueva en su lugar» y asigna un nombre a tu App para crearla.
Una vez que hagas clic en completar, obtendrás tus claves de API y el token Bearer, 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 en tu equipo local. Los necesitarás para hacer las llamadas a la API en el siguiente paso. Nota: Las claves en la captura de pantalla de arriba están ocultas, pero en tu propio Portal de desarrolladores podrás ver los valores reales de la API key, API secret key y Bearer token.  

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

Los endpoints del timeline de Tweets del usuario y del timeline de menciones del usuario te 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 búsqueda de usuarios v2. Reemplaza USER_NAME por el nombre de usuario que elijas y XXXX por tu propio token de portador obtenido arriba 
  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"
   }
}

​
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 token de portador obtenido arriba) 
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 los Posts de manera predeterminada (véase el ejemplo a continuación). 
{
   "id": "1334200897081987072",
   "text": "👀 Si eres nuevo en la X API v2, consulta esta guía paso a paso para hacer tu primera solicitud https://t.co/4rZqThpSbp"
}
Si deseas que se devuelvan campos adicionales como parte de la respuesta (por ejemplo, información del usuario o campos adicionales de Tweet como context annotations), deberás especificar esos fields explícitamente en tu solicitud. Aprende cómo hacerlo en la guía sobre cómo usar fields y expansions. También puedes obtener estos Posts usando el lenguaje de programación de tu preferencia. 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 los Posts del usuario

Una vez que sabes cómo obtener Posts usando los endpoints de la cronología de Tweets del usuario y de menciones del usuario, puedes empezar 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 se devuelva 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 con nombre en las menciones. Aquí tienes un ejemplo: 
{
   "domain": {
       "id": "47",
       "name": "Marca",
       "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 esas entidades 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 preview_image_url en los tweet.media fields y attachments.media_keys en 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ás 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 explorar los Posts de un usuario, también puedes usar otras API y servicios para hacer más con los Posts. A continuación, encontrarás algunos recursos útiles al usar los endpoints de la cronología de Tweets de usuario y de menciones de usuario.

​
Recursos