Buscar Posts (archivo completo)

​

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

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

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

​

Requisitos previos

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

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 Empresarial 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 requeridas. Asegúrese de guardar todas las credenciales en un lugar seguro.

​

Pasos para crear una solicitud de recuentos de Post de archivo completo

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í vamos a usar 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 claves y tokens, específicamente el App Access Token (también conocido como 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 claves y tokens en 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 hizo correctamente.  

Paso tres: Cree una consulta

Cada solicitud de recuentos de Post de archivo completo requiere una sola consulta. Para este ejemplo, vamos a usar 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 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	Consulta que se enviará al endpoint de recuentos de Post de archivo completo

Step four (optional): Specify the granularity and time period

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

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

Key	Value	Description
granularity	day	La granularidad para los resultados de recuentos de Post. Los valores posibles son day, hour o minute
start_time	2021-05-01T00:00:00Z	La marca de tiempo UTC más antigua a partir de la cual se proporcionarán los Posts
end_time	2021-06-01T00:00:00Z	La marca de tiempo UTC más antigua a partir de 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 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	Añadirá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 establecido el valor correcto para next_token, haz clic en el botón “Send” y recibirás la siguiente página de resultados.