Guía rápida

​

Introducción al endpoint de consulta de Posts de List

Esta guía de inicio rápido te ayudará a realizar tu primera solicitud al endpoint de consulta de Posts de List usando Postman.

Visita nuestro repositorio de GitHub de X API v2 sample code si quieres ver ejemplos de código en distintos lenguajes.

​

Requisitos previos

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

• Regístrate para obtener una cuenta de desarrollador y espera la aprobación.
• Crea un Project y una developer App 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 búsqueda de Posts de una Lista

​

Paso uno: Comienza con una herramienta o biblioteca

Existen varias herramientas, ejemplos de código y bibliotecas que puedes usar para hacer una solicitud a este endpoint, pero aquí utilizaremos 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:

Agregar X API v2 a Postman

Una vez que tengas cargada la colección de X API v2 en Postman, navega a la carpeta “List”, selecciona la carpeta “List Posts” y luego elige “List Posts lookup”.  

​

Paso dos: Autentica tu solicitud

Para realizar correctamente una solicitud a la X API, debes verificar que tienes permiso. Para hacerlo con este endpoint, debes autenticar tu solicitud con alguno de estos métodos de autenticación: App only, Código de autorización de OAuth 2.0 con PKCE o Contexto de usuario de OAuth 1.0a.

Para simplificar, usaremos App only con esta solicitud, pero si deseas solicitar métricas privadas o Posts, tendrás que usar uno de los otros métodos de autenticación.

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

Si lo has hecho correctamente, estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud.  

​

Paso tres: identifica y especifica de qué Lista deseas obtener Posts

Debes especificar una Lista que deseas recibir en la solicitud. Puedes encontrar el id de la Lista navegando a x.com, haciendo clic en una Lista y luego consultando la URL. Por ejemplo, el id de la Lista en la siguiente URL es 84839422.

https://x.com/i/lists/84839422

El id de destino puede ser cualquier id de Lista válido. En Postman, ve a la pestaña “Params” e introduce tu id en la columna “Value” de la variable de ruta id. Asegúrate de no incluir espacios antes o después de ningún id.

Key	Value
id	84839422 (id de la Lista)

​

Paso cuatro: Identifique y especifique qué fields desea recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá los fields predeterminados del Post object en su respuesta: id y text.

Si desea recibir fields adicionales, deberá especificarlos en su solicitud con los parámetros tweet.fields y/o expansion.

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

• El field adicional created_at en el objeto principal Lists.

• El user object completo usando el parámetro de expansion

• El field adicional user.created_at en el objeto de usuario asociado.

En Postman, vaya a la pestaña “Params” y agregue el siguiente par key:value a la tabla “Query Params”:

Key	Value	Returned fields
tweet.fields	created_at	created_at
expansions	author_id	includes.users.id, includes.users.name, includes.users.username
user.fields	created_at	includes.users.created_at

Ahora debería ver una URL similar junto al botón “Send”:

https://api.x.com/2/lists/84839422/tweets?expansions=author_id&user.fields=created_at&max_results=1

​

Paso cinco: Realiza tu solicitud y revisa tu respuesta

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

{
  "data": [
    {
      "author_id": "4172587277",
      "id": "1458172421115101189",
      "text": "A Alemanha registrou nesta semana um recorde de novos casos de Covid-19. Segundo o governo e especialistas em Saúde, pessoas não vacinadas são responsáveis pela situação \nhttps://t.co/4POyaPwMLu"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "MomentsBrasil",
        "name": "Twitter Moments Brasil",
        "created_at": "2015-11-12T16:46:02.000Z",
        "id": "4172587277"
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}

Ten en cuenta: La respuesta de este endpoint permitirá consultar los 800 Posts más recientes de una Lista determinada