Saltar al contenido principal

​
Introducción al endpoint de consulta de Posts de una List

Esta Guía rápida le ayudará a realizar su primera solicitud al endpoint de consulta de Posts de una List utilizando Postman. Visite nuestro repositorio de GitHub X API v2 sample code si desea ver código de muestra en diferentes lenguajes.

​
Requisitos previos

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

​
Pasos para crear una solicitud de consulta de Posts de una List

​
Paso uno: Comience con una herramienta o biblioteca

Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí usaremos Postman para simplificar el proceso. Para cargar en su entorno la colección de Postman de X API v2, haga clic en el siguiente botón:
Una vez que tenga cargada en Postman la colección de X API v2, navegue a la carpeta “List”, seleccione la carpeta “List Posts” y luego elija “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 mediante uno de los siguientes métodos: App only, OAuth 2.0 Authorization Code with PKCE o OAuth 1.0a User Context. Para simplificar, utilizaremos App only en esta solicitud; sin embargo, si deseas solicitar metrics privadas o Posts, deberás usar uno de los otros métodos de autenticación. Para utilizar App only, debes agregar tus keys and tokens (específicamente el App only Access Token, también conocido como el App only Bearer Token) en Postman seleccionando el entorno llamado “X API v2” (en la esquina superior derecha de Postman) y agregando tus keys and tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de 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é List deseas recuperar Posts

Debes especificar una List que deseas recibir en la solicitud. Puedes encontrar el id de la List navegando a x.com, haciendo clic en una List y luego mirando la URL. Por ejemplo, el id de la List en la siguiente URL es 84839422. https://x.com/i/lists/84839422 El id de destino puede ser cualquier id de List 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.
KeyValue
id84839422 (id de la List)

​
Paso cuatro: Identifique y especifique qué campos desea recuperar

Si hace clic en el botón “Send” después del paso tres, recibirá en su respuesta los campos predeterminados del Objeto de Post: id y text. Si desea recibir campos adicionales, deberá especificarlos en su solicitud con los parámetros tweet.fields y/o expansions. Para este ejercicio, solicitaremos tres conjuntos adicionales de campos de distintos objetos:
  • El campo adicional created_at en el objeto principal Lists.
  • El objeto de usuario completo usando el parámetro expansions
  • El campo 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”:
KeyValueReturned fields
tweet.fieldscreated_atcreated_at
expansionsauthor_idincludes.users.id,
includes.users.name,
includes.users.username
user.fieldscreated_atincludes.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: Realice su solicitud y revise la respuesta

Una vez que tenga todo configurado, haga clic en el botón “Send” y recibirá una respuesta similar al siguiente ejemplo: 
{
  "data": [
    {
      "author_id": "4172587277",
      "id": "1458172421115101189",
      "text": "Alemania registró esta semana un récord de nuevos casos de COVID-19. Según el gobierno y especialistas en salud, las personas no vacunadas son responsables de la situación \nhttps://t.co/4POyaPwMLu"
    }
  ],
  "includes": {
    "users": [
      {
        "username": "MomentsBrasil",
        "name": "X Moments Brasil",
        "created_at": "2015-11-12T16:46:02.000Z",
        "id": "4172587277"
      }
    ]
  },
  "meta": {
    "result_count": 1,
    "next_token": "7140dibdnow9c7btw3z2vwioavpvutgzrzm9icis4ndix"
  }
}
Tenga en cuenta: La respuesta de este endpoint admitirá consultar los 800 Posts más recientes de una List determinada
⌘I