Saltar al contenido principal

​
Introducción al endpoint de consulta de Likes

Esta guía de inicio rápido te ayudará a realizar tu primera solicitud al endpoint de consulta de Likes usando Postman. Si deseas ver código de ejemplo en distintos lenguajes, visita nuestro repositorio de GitHub X API v2 sample code.  

​
Requisitos previos

Para completar esta guía, necesitarás contar con un conjunto de keys and tokens, que puedes generar siguiendo estos pasos:
  1. Solicita una cuenta de desarrollador y espera la aprobación.
  2. Crea un Project y una App de desarrollador asociada en el Portal de desarrolladores.
  3. Ve a la página “Keys and tokens” de tu App y guarda tus API Keys, Access Tokens y Bearer Token en tu gestor de contraseñas.

​
Pasos para crear una solicitud de búsqueda de Me gusta

Paso uno: Comienza con una herramienta o biblioteca Hay varias herramientas, ejemplos de código y bibliotecas que puedes usar para hacer una solicitud a este endpoint, pero aquí usaremos la herramienta Postman para simplificar el proceso. Para cargar la colección de Postman de X API v2 en tu entorno, haz clic en el siguiente botón:
Añadir X API v2 a Postman Una vez que tengas la colección de X API v2 cargada en Postman, navega a la carpeta “Likes” y selecciona “Liking users”.   Paso dos: Autentica tu solicitud Para realizar una solicitud correcta a este endpoint, necesitarás usar OAuth 1.0a User Context o autenticación con OAuth 2.0 Bearer Token. Para ello, debes agregar las siguientes claves y tokens en Postman seleccionando el entorno llamado “X API v2” y añadiendo las siguientes variables en los campos Initial value y Current value:
  • consumer_key con tu API Key
  • consumer_secret con tu API Key Secret
  • access_token con tu Access Token
  • token_secret con tu Access Token Secret  
Paso tres: Especifica un Tweet Con este endpoint, debes especificar el ID del Tweet del que quieres obtener los usuarios a los que les gusta. Puedes encontrar el ID de un Tweet navegando a ese Tweet en X y tomando el código numérico al final de la URL. Por ejemplo, el ID de Tweet de la siguiente URL es 1354143047324299264. https://x.com/TwitterDev/status/1354143047324299264 En Postman, navega a la pestaña “Params” e ingresa este nombre de usuario en la columna “Value” de la variable de ruta tweet_id (al final de la sección), asegurándote de no incluir espacios antes o después de los nombres de usuario. 
KeyValue
idEl ID del Tweet del que quieres obtener los usuarios a los que les gusta
Paso cuatro: Identifica y especifica qué fields deseas recuperar Si haces clic en el botón “Send” después del paso tres, recibirás en tu respuesta los fields predeterminados del user object: id, name y username. Si deseas recibir fields adicionales más allá de id, name y username, tendrás que especificarlos en tu solicitud con los parámetros fields y/o expansions. Para este ejercicio, solicitaremos tres conjuntos adicionales de fields de diferentes objetos:
  1. El field adicional user.created_at en los objetos de usuario principales.
  2. Los fields predeterminados del objeto de Tweets fijados asociados para los usuarios devueltos: id y text.
  3. El field adicional tweet.created_at en los objetos de Tweet asociados.
En Postman, navega a la pestaña “Params” y agrega el siguiente par key:value en la tabla “Query Params”:
KeyValueReturned fields
user.fieldscreated_atuser.created_at
expansionspinned_tweet_idtweet.id, tweet.text
tweet.fieldscreated_attweet.created_at
Ahora deberías ver la siguiente URL junto al botón “Send”: https://api.x.com/2/tweets/1354143047324299264/liking_users?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at Paso cinco: Realiza tu solicitud y revisa tu respuesta Una vez que tengas todo configurado, presiona el botón “Send” y recibirás una respuesta similar al siguiente ejemplo de respuesta: 
{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Twitter Support"
    },
    {
      "created_at": "2007-02-20T14:35:54.000Z",
      "id": "783214",
      "username": "Twitter",
      "name": "Twitter"
    },
    {
      "pinned_tweet_id": "1389270063807598594",
      "created_at": "2018-11-21T14:24:58.000Z",
      "id": "1065249714214457345",
      "username": "TwitterSpaces",
      "name": "Spaces"
    },
    {
      "pinned_tweet_id": "1293595870563381249",
      "created_at": "2007-05-23T06:01:13.000Z",
      "id": "6253282",
      "username": "XAPI",
      "name": "X API"
    }
  ],
  "includes": {
    "tweets": [
      {
        "created_at": "2021-05-03T17:26:09.000Z",
        "id": "1389270063807598594",
        "text": "a partir de ahora, cualquier persona con 600 o más seguidores puede alojar un Space.\n\nsegún lo que hemos aprendido, es probable que estas cuentas tengan una buena experiencia al alojar gracias a su audiencia existente. antes de llevar la capacidad de crear un Space a todo el mundo, nos estamos enfocando en algunas cosas. 🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: lanzamiento de Early Access\n\nHoy anunciamos el Early Access a los primeros endpoints de la nueva Twitter API.\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}
Paso seis: Obtener los Tweets que le gustaron a un usuario Quizás también quieras realizar una solicitud para obtener los Tweets que le gustaron a un usuario. Con el endpoint de búsqueda de Likes, puedes obtener información sobre los Tweets que le gustaron a un usuario. Para hacerlo, navega a la carpeta “Likes” y selecciona “Liked Tweets”.  Con este endpoint, debes especificar el id de usuario del que quieres obtener los Tweets con Like. Puedes usar el endpoint de user lookup para obtener esta información. En Postman, navega a la pestaña “Params” e ingresa este nombre de usuario en la columna “Value” de la variable de ruta id (al final de la sección), asegurándote de no incluir espacios antes o después de los nombres de usuario. 
KeyValue
idEl id de usuario del que quieres obtener los Tweets con Like
max_results5
Ahora puedes ver una URL similar con tu id en lugar del de TwitterDev junto al botón “Send”:   https://api.x.com/2/users/2244994945/liked_tweets?max_results=5 Una vez que tengas todo configurado, pulsa el botón “Send” y recibirás una respuesta similar al siguiente ejemplo de respuesta: 
{
  "data": [
    {
      "id": "1362449997430542337",
      "text": "Es un honor ser el primer desarrollador en aparecer en el love fest de @TwitterDev 🥰♥️😍 https://t.co/g8TsPoZsij"
    },
    {
      "id": "1365416026435854338",
      "text": "Estamos muy contentos por nuestro socio oficial, @Brandwatch, y sus grandes noticias. https://t.co/3DwWBNSq0o https://t.co/bDUGbgPkKO"
    },
    {
      "id": "1296487407475462144",
      "text": "Consulta este artículo en @TwitterDev para saber más sobre cómo estamos analizando datos de redes sociales para comprender esta crisis de #saludpública en evolución https://t.co/sIFLXRSvEX."
    },
    {
      "id": "1294346980072624128",
      "text": "Despierto tras cinco años de letargo https://t.co/OEPVyAFcfB"
    },
    {
      "id": "1283153843367206912",
      "text": "@wongmjane Ojalá pudiéramos contarte más, pero solo soy una tetera 👀"
    }
  ],
  "meta": {
        "next_token": "7140dibdnow9c7btw4539n0vybdnx19ylpayqf16fjt4l",
    	  "result_count": 5
  }
}