Explora los Posts y menciones de un usuario con la X API v2

Introducción

Mientras que el endpoint recent search solo te permite obtener Posts publicados en los últimos 7 días, los endpoints de timeline de Posts de usuario y timeline de menciones de usuario te permiten recuperar Posts y menciones más antiguos que los últimos 7 días, para un usuario autorizado (usando el user ID). Los desarrolladores pueden usar estos endpoints para estudiar temas, entidades y sentimiento de los Posts del timeline o menciones de un usuario. En este tutorial te mostraremos cómo explorar los Posts y menciones de un usuario usando los endpoints user Tweet timeline y user mention timeline.

Requisitos previos

Para usar los endpoints user Tweet timeline y user mention timeline, necesitarás tener una cuenta de desarrollador válida.
También necesitarás un Project creado.
Debes haberte registrado para una cuenta de desarrollador y haber activado la nueva experiencia de Developer Console.
El acceso está disponible con claves y tokens activos para una App de desarrollador que esté asociada a un Project creado en la Developer Console.
Un Bearer Token de tu App en la X Developer Console.
Si no tienes una cuenta de desarrollador aprobada, puedes solicitar una.

Cuenta de desarrollador aprobada

Si aún no tienes una, puedes solicitarla.

Crear un Project y conectar una App

En la Developer Console, haz clic en crear una nueva App.

Dale un nombre, selecciona el caso de uso apropiado 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 hacer una solicitud HTTP a la X API).

Haz clic en ‘create a new App instead’ y dale un nombre a tu App para crear una nueva App.

Una vez que hagas clic en completar, 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 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 arriba están ocultas, pero en tu propia Developer Console podrás ver los valores reales de la API key, la API secret key y el Bearer token.

Cómo obtener el user ID de un usuario para usarlo en los endpoints user Tweet timeline y user mention timeline

Los endpoints user Tweet timeline y user mention timeline te permiten obtener Posts usando el user ID. Para obtener el user ID a partir de un nombre de usuario, puedes usar el nuevo endpoint user lookup v2. Reemplaza USER_NAME con el nombre de usuario de tu elección y XXXX con tu propio bearer token obtenido arriba.

  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'

Verás el user ID en la respuesta como se muestra a continuación:

{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}

Conectarse a los endpoints user Tweet timeline y user mention timeline

Para obtener el user Tweet timeline de un usuario, ejecuta el siguiente comando curl en tu terminal (asegúrate de reemplazar USER_ID con el user ID de tu elección y XXXX con 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 contiene por defecto el ID y el texto de los Posts (ejemplo abajo).

{
   "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 quieres que se devuelvan campos adicionales como parte de la respuesta (como información del usuario, campos adicionales del Tweet como context annotations, etc.), deberás especificar esos campos explícitamente en tu respuesta. Aprende cómo hacerlo en la guía sobre el uso de fields y expansions. También puedes obtener estos Posts usando los lenguajes de programación de tu elección. 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.

Explorando los Posts del usuario

Una vez que sepas cómo obtener Posts usando los endpoints user Tweet timeline y user mention timeline, puedes empezar a explorar sus Posts. Por ejemplo, si quisieras identificar entidades nombradas 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 del Tweet:

curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'

En la respuesta, verás si hay entidades nombradas presentes en las menciones. Aquí tienes un ejemplo:

{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Brands and Companies"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}

Si quisieras ver qué entidades populares aparecen en tus menciones, podrías llevar un conteo de entidades populares parseando cada Tweet en las menciones. Si quisieras explorar la URL de imagen de vista previa para todos los Posts de tu timeline que contienen media, puedes hacer lo siguiente: En la solicitud a la 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 el 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 entiendas cómo navegar por los Posts de un usuario, también puedes usar otras APIs y servicios para hacer más cosas con los Posts. A continuación tienes algunos recursos útiles al usar los endpoints user Tweet timeline y user mention timeline.

Recursos

Aprende más sobre los endpoints user Tweet timeline y user mention timeline.
Consulta la referencia de API del endpoint user Tweet timeline para conocer más sobre lo que ofrece.
Consulta la referencia de API del endpoint user mention timeline para conocer más sobre lo que ofrece.
Inspírate leyendo nuestros otros tutoriales.

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Explora los Posts y menciones de un usuario con la X API v2

Introducción

Requisitos previos

Cuenta de desarrollador aprobada

Crear un Project y conectar una App

Cómo obtener el user ID de un usuario para usarlo en los endpoints user Tweet timeline y user mention timeline

Conectarse a los endpoints user Tweet timeline y user mention timeline

Explorando los Posts del usuario

Recursos

​Introducción

​Requisitos previos

​Cuenta de desarrollador aprobada

​Crear un Project y conectar una App

​Cómo obtener el user ID de un usuario para usarlo en los endpoints user Tweet timeline y user mention timeline

​Conectarse a los endpoints user Tweet timeline y user mention timeline

​Explorando los Posts del usuario

​Recursos

Introducción

Requisitos previos

Cuenta de desarrollador aprobada

Crear un Project y conectar una App

Cómo obtener el user ID de un usuario para usarlo en los endpoints user Tweet timeline y user mention timeline

Conectarse a los endpoints user Tweet timeline y user mention timeline

Explorando los Posts del usuario

Recursos