Buscar Posts (archivo completo)

​

Introducción al endpoint de conteos de Post del archivo completo    

Esta Guía rápida le ayudará a realizar su primera solicitud al endpoint de conteos de Post del archivo completo usando Postman, una herramienta gráfica que le permite realizar 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

El endpoint de conteos de Post del archivo completo actualmente solo está disponible para quienes tienen acceso Pro o Enterprise. Para usar este endpoint, debe solicitar acceso Pro o Enterprise. 

Además de ser aprobado para el acceso, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

• Vaya a su Project con acceso Enterprise en el portal de desarrolladores y asegúrese de tener una developer App asociada dentro de ese Project.

• 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 recuento de Posts de todo el archivo

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 la herramienta Postman para simplificar el proceso.

Para cargar la colección de Postman de X API v2 en su entorno, haga clic en el siguiente botón:

Agregar X API v2 a Postman

Una vez que tenga la colección de X API v2 cargada en Postman, navegue a Post counts > Full-archive 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 a los campos “initial value” y “current value” (haciendo clic en el ícono 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 recuento de Posts de todo el archivo requiere una única 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/minúsculas):

from:XDevelopers

En Postman, vaya 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 que se enviará al endpoint de recuento de Posts de todo el archivo

Step four (optional): Especifique la granularidad y el período de tiempo

Si hace clic en el botón “Send” después del paso tres, obtendrá el recuento predeterminado de Posts de todo el archivo: por hora durante los últimos 30 días. Si desea obtener el recuento de Posts de todo el archivo por día, deberá agregar el parámetro granularity con el valor day. Si desea recuentos de Posts de hace más de 30 días, deberá especificar los parámetros start_time y end_time con los valores deseados. 

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

Key	Value	Description
granularity	day	La granularidad de los resultados de recuento de Posts. Los valores posibles son day, hour o minute
start_time	2021-05-01T00:00:00Z	La marca de tiempo UTC más antigua desde la cual se proporcionarán los Posts
end_time	2021-06-01T00:00:00Z	La marca de tiempo UTC más antigua desde la cual se proporcionarán los Posts.

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

https://api.x.com/2/tweets/counts/all?query=from%3AXDevelopers&start_time=2021-05-01T00:00:00Z&end_time=2021-06-01T00:00:00Z&granularity=day

Paso cinco: realice su solicitud y revise su respuesta

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

{
   "data": [
       {
           "end": "2021-05-02T00:00:00.000Z",
           "start": "2021-05-01T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-03T00:00:00.000Z",
           "start": "2021-05-02T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-04T00:00:00.000Z",
           "start": "2021-05-03T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-05T00:00:00.000Z",
           "start": "2021-05-04T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-06T00:00:00.000Z",
           "start": "2021-05-05T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-07T00:00:00.000Z",
           "start": "2021-05-06T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-08T00:00:00.000Z",
           "start": "2021-05-07T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-09T00:00:00.000Z",
           "start": "2021-05-08T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-10T00:00:00.000Z",
           "start": "2021-05-09T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-11T00:00:00.000Z",
           "start": "2021-05-10T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-12T00:00:00.000Z",
           "start": "2021-05-11T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-13T00:00:00.000Z",
           "start": "2021-05-12T00:00:00.000Z",
           "tweet_count": 6
       },
       {
           "end": "2021-05-14T00:00:00.000Z",
           "start": "2021-05-13T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-15T00:00:00.000Z",
           "start": "2021-05-14T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-16T00:00:00.000Z",
           "start": "2021-05-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-17T00:00:00.000Z",
           "start": "2021-05-16T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-18T00:00:00.000Z",
           "start": "2021-05-17T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-19T00:00:00.000Z",
           "start": "2021-05-18T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-20T00:00:00.000Z",
           "start": "2021-05-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-21T00:00:00.000Z",
           "start": "2021-05-20T00:00:00.000Z",
           "tweet_count": 8
       },
       {
           "end": "2021-05-22T00:00:00.000Z",
           "start": "2021-05-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-23T00:00:00.000Z",
           "start": "2021-05-22T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-24T00:00:00.000Z",
           "start": "2021-05-23T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-25T00:00:00.000Z",
           "start": "2021-05-24T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-26T00:00:00.000Z",
           "start": "2021-05-25T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-27T00:00:00.000Z",
           "start": "2021-05-26T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-28T00:00:00.000Z",
           "start": "2021-05-27T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-05-29T00:00:00.000Z",
           "start": "2021-05-28T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-05-30T00:00:00.000Z",
           "start": "2021-05-29T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-05-31T00:00:00.000Z",
           "start": "2021-05-30T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-01T00:00:00.000Z",
           "start": "2021-05-31T00:00:00.000Z",
           "tweet_count": 0
       }
   ],
   "meta": {
       "total_tweet_count": 22
   }
}

Paso seis: pagina por tus resultados

Si el objeto ‘meta’ de tu respuesta también contiene next_token, puedes pasar su valor al parámetro de consulta next_token.

Clave	Valor	Descripción
next_token	Agregarás el next_token que obtengas del objeto meta de tu solicitud anterior y lo colocarás aquí.	Si tu solicitud más reciente no devuelve el resto de los resultados, recibirás un next_token en el objeto meta. Tomarás el valor de ese campo y lo usarás como valor del parámetro next_token en tu siguiente solicitud, manteniendo constantes todos los demás parámetros de la solicitud.

Una vez que hayas configurado el valor correcto para next_token, pulsa el botón “Send” y recibirás la siguiente página de resultados.