Buscar Posts (recientes)

​

Introducción al endpoint de conteos recientes de Posts

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

Si desea ver código de ejemplo en diferentes lenguajes de programación, visite nuestro repositorio de GitHub de 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 necesarias. Asegúrese de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud de recuentos 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:

Agregar X API v2 a 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 claves y tokens, específicamente el App Access Token (también conocido como el App-only Bearer Token) en Postman. Puede hacerlo seleccionando el entorno llamado “X API v2” en la esquina superior derecha de Postman y agregando sus claves y tokens en los campos “initial value” y “current value” (haciendo clic en el ícono del ojo junto al menú desplegable del entorno).

Si lo hizo correctamente, esta variable se incorporará automáticamente en la pestaña de autorización de la solicitud.  

Paso tres: Cree una consulta

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

from:XDevelopers

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

Key	Value	Description
query	from:XDevelopers	Consulta para enviar al endpoint de recuentos 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á los recuentos de Posts recientes predeterminados: por hora durante los últimos siete días. Si desea obtener recuentos de Posts recientes por día, deberá agregar el parámetro granularity con el valor day.

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

Key	Value	Description
granularity	day	La granularidad de los resultados de recuentos 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 la 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
   }
}