Buscar Posts (recientes)

​

Introducción al endpoint de conteos de Posts recientes

Esta Guía rápida le ayudará a realizar su primera solicitud al endpoint de conteos de Posts recientes con Postman, una herramienta gráfica que permite enviar solicitudes HTTP.

Si desea ver código de muestra en diferentes lenguajes de programación, visite nuestro repositorio de GitHub X API v2 sample code.

​

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:

• Regístrese para obtener una cuenta de desarrollador y reciba la aprobación.
• Cree un Project y una developer App asociada en el portal de desarrolladores.
• Vaya a la página “Keys and tokens” de su App para generar las credenciales requeridas. Asegúrese de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud de conteo de Posts recientes

Paso uno: Comience con una herramienta o biblioteca

Hay varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí usaremos la herramienta 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:

Add X API v2 to Postman

Una vez que tenga cargada la colección de X API v2 en Postman, navegue a Post counts > Recent Post counts request.

Paso dos: Autentique su solicitud

Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso. Para hacerlo con este endpoint, debe autenticar su solicitud con los métodos de autenticación OAuth 2.0 App-Only.

Debe agregar sus keys and tokens, específicamente el App Access Token (también conocido como el 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 keys and tokens en los campos “initial value” y “current value” (haciendo clic en el icono de ojo junto al menú desplegable del entorno).

Esta variable se incorporará automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.  

Paso tres: Cree una query

Cada solicitud de conteo de Posts recientes requiere una sola query. Para este ejemplo, usaremos una query que coincida con los Posts publicados por la cuenta @XDevelopers. Para esta query usamos el operador from: y lo establecemos en XDevelopers (no distingue mayúsculas y minúsculas):

from:XDevelopers

En Postman, navegue a la pestaña “Params” e ingrese este ID, o una cadena de IDs de Post separadas por comas, en la columna “Value” del parámetro ids.

Key	Value	Description
query	from:XDevelopers	Query para enviar al endpoint de conteo de Posts recientes

Paso cuatro (opcional): Especifique la granularidad de la solicitud

Si hace clic en el botón “Send” después del paso tres, obtendrá el conteo de Posts recientes predeterminado: por hora durante los últimos siete días. Si desea obtener conteos de Posts recientes por día, deberá agregar el parámetro granularity con un valor de day.

En Postman, navegue a la pestaña “Params” e ingrese day en la columna “Value” del parámetro granularity.

Key	Value	Description
granularity	day	La granularidad para los resultados de conteo de Posts. Los valores posibles son day, hour o minute

Ahora debería ver la siguiente URL junto al botón “Send”:

https://api.x.com/2/tweets/counts/recent?query=from%3AXDevelopers&granularity=day

Paso cinco: Realice su solicitud y revise su respuesta

Una vez que tenga todo configurado, presione el botón “Send” y recibirá la siguiente respuesta:

{
   "data": [
       {
           "end": "2021-06-16T00:00:00.000Z",
           "start": "2021-06-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-17T00:00:00.000Z",
           "start": "2021-06-16T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-18T00:00:00.000Z",
           "start": "2021-06-17T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-06-19T00:00:00.000Z",
           "start": "2021-06-18T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-20T00:00:00.000Z",
           "start": "2021-06-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-21T00:00:00.000Z",
           "start": "2021-06-20T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-22T00:00:00.000Z",
           "start": "2021-06-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-23T00:00:00.000Z",
           "start": "2021-06-22T00:00:00.000Z",
           "tweet_count": 2
       }
   ],
   "meta": {
       "total_tweet_count": 6
   }
}