Consulta de Retweets

​

Primeros pasos con el endpoint de búsqueda de Retweets

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint de búsqueda de Retweets usando Postman. Si desea ver código de ejemplo en distintos lenguajes, visite nuestro repositorio de GitHub X API v2 sample code.

​

Requisitos previos

Para completar esta guía, necesitarás un conjunto de claves y tokens para autenticar tu solicitud. Puedes generar estas claves y tokens siguiendo estos pasos:

• Regístrate para obtener una cuenta de desarrollador y espera la aprobación.
• Crea un Proyecto y una App de desarrollador asociada en el Portal de desarrolladores.
• Ve a la página “Keys and tokens” de tu App para generar las credenciales necesarias. Asegúrate de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud de consulta de Retweets

Paso uno: Comienza con una herramienta o librería

Existen 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 la X API v2 en tu entorno, haz clic en el siguiente botón:

Agregar X API v2 a Postman

Una vez que hayas cargado la colección de X API v2 en Postman, navega a la carpeta “Retweets” y selecciona “Retweeted by”.

Paso dos: Autentique su solicitud

Para realizar correctamente una solicitud a la X API, debe verificar que cuenta con los permisos necesarios. Para ello, este endpoint requiere que autentique su solicitud mediante alguno de los siguientes métodos de autenticación: OAuth 2.0 App-Only, Código de autorización de OAuth 2.0 con PKCE o Contexto de usuario de OAuth 1.0a.

Por simplicidad, utilizaremos OAuth 2.0 App-Only con esta solicitud, pero deberá usar uno de los otros métodos de autenticación si desea solicitar métricas privadas o retweets.

Para utilizar OAuth 2.0 App-Only, debe agregar sus claves y tokens, específicamente elApp Access Token (también conocido como App-only Bearer Token) a Postman. Puede hacerlo seleccionando el entorno llamado “X API v2” en la esquina superior derecha de Postman y agregando sus claves y tokens a los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al menú desplegable de entorno).

Estas variables se cargarán automáticamente en la pestaña de autorización de la solicitud si has configurado esto correctamente.

Paso tres: Especificar un Post

Con este endpoint, debes especificar el ID del Post del cual deseas obtener los usuarios que han hecho retweet. Puedes encontrar el ID de un Post navegando a ese Post en X y extrayendo el código numérico al final de la URL. Por ejemplo, el ID del Post de la siguiente URL es 1354143047324299264.

https://x.com/TwitterDev/status/1354143047324299264

En Postman, ve a la pestaña “Params” e ingresa este nombre de usuario en la columna “Value” de la variable de ruta id (en la parte inferior de la sección), asegurándote de no incluir espacios antes ni después de los nombres de usuario.

Clave	Valor
id	El id del Post del que quieres obtener los usuarios que retuitearon

Paso cuatro: Identifica y especifica qué campos deseas recuperar

Si haces clic en el botón “Enviar” después del paso tres, recibirás los campos predeterminados del objeto user en tu respuesta: id, name y username.

Si desea recibir campos adicionales además de id, name y username, deberá especificar dichos campos en su solicitud con los parámetros fields y/o expansions.

Para este ejercicio, solicitaremos tres conjuntos adicionales de fields de distintos objetos:

1. El campo adicional user.created_at en los objetos de usuario primarios.
2. Los campos predeterminados del objeto de Posts fijados asociados para los usuarios devueltos: id y text.
3. El campo adicional tweet.created_at en los objetos Post asociados.

En Postman, ve a la pestaña “Params” y añade el siguiente par clave:valor a la tabla “Query Params”:

Clave	Valor	Campos retornados
user.fields	creado_en	usuario.creado_en
expansions	anclado_Tweet_id	tweet.id, tweet.text
tweet.fields	creado_en	Tweet.created_en

Ahora deberías ver la siguiente URL junto al botón “Enviar”:

https://api.x.com/2/tweets/1354143047324299264/retweeted_by?user.fields=created_at&expansions=pinned_tweet_id&tweet.fields=created_at

Paso cinco: Haz tu solicitud y revisa la respuesta

Una vez que tengas todo configurado, haz clic en el botón «Send» y recibirás una respuesta similar al siguiente ejemplo:

{
  "data": [
    {
      "created_at": "2008-12-04T18:51:57.000Z",
      "id": "17874544",
      "username": "TwitterSupport",
      "name": "Soporte de Twitter"
    },
    {
      "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": "ahora, cualquier persona con 600 o más seguidores puede ser anfitrión de un Space.\n\ncon base en lo que hemos aprendido, es probable que estas cuentas tengan una buena experiencia como anfitriones gracias a su audiencia existente. antes de ofrecer la capacidad de crear un Space a todos, nos estamos enfocando en algunas cosas. 🧵"
      },
      {
        "created_at": "2020-08-12T17:11:04.000Z",
        "id": "1293595870563381249",
        "text": "X API v2: Acceso anticipado lanzado\n\nHoy anunciamos el acceso anticipado a los primeros endpoints de la nueva Twitter API.\n\n#TwitterAPI #EarlyAccess #VersionBump https://t.co/g7v3aeIbtQ"
      }
    ]
  }
}