Introducción

Los endpoints de conteo de Posts de v2 permiten a los desarrolladores comprender y obtener el volumen de data para una query determinada. Esto puede ser útil por varias razones, entre ellas:

• Comprender el volumen de Posts para una palabra clave a fin de crear visualizaciones, como líneas de tendencia.

• Comprender el período en el que ocurrió un evento o conversación, para asegurarse de que la query capture la data relevante.

• Comprender cuántos Posts devolverá una query de búsqueda, con el fin de refinar la query antes de usar los endpoints de búsqueda reciente o de archivo completo. Tenga en cuenta: Los conteos no siempre coincidirán con el resultado que devolverán los endpoints de búsqueda porque estos pasan por procesos de cumplimiento adicionales por los que los endpoints de conteo no pasan.

• Comprender el tamaño de la conversación en torno a un tema, sin tener que extraer la data sin procesar, y contabilizar los Posts frente a su Post cap mensual.

Al desarrollar una query, estará limitado a una cierta longitud de query y a operadores específicos según su nivel de acceso.

• Si usa un Project con acceso Pro, puede usar todos los operadores disponibles y queries de hasta 1024 caracteres de longitud.

• Si usa un Project con acceso Enterprise, puede usar todos los operadores disponibles y queries de hasta 4096 caracteres de longitud.

También puede especificar la granularidad (que puede ser día, hora o minuto), así como el período para el que necesita los conteos de Posts (usando los parámetros start_time y end_time). La granularidad de tiempo predeterminada que usa este endpoint es hora, lo que significa que, si no especifica el parámetro de granularidad, el endpoint le dará los conteos de Posts por hora de los últimos 7 días.

Configuración de la cuenta

Para acceder a estos endpoints, necesitará:

• Una cuenta de desarrollador aprobada.
• Autenticarse usando las keys and tokens de una App de desarrollador que se encuentra dentro de un Project.

Obtenga más información sobre cómo obtener acceso a los endpoints de X API v2 en nuestra guía de introducción.

​

Recuentos recientes de Posts

El endpoint de recuentos recientes de Posts permite recuperar de forma programática el número de Posts para una query durante los últimos siete días. Este endpoint está disponible para cualquier persona que utilice keys and tokens asociados a una App dentro de un Project y utiliza OAuth 2.0 App-Only para la autenticación.

​

Recuentos de Posts de todo el archivo

El endpoint de recuentos de Posts de todo el archivo permite recuperar de forma programática el recuento numérico de Posts para una query, a partir de todo el archivo de Posts públicos. Actualmente, este endpoint solo está disponible para quienes han sido aprobados para Academic Research o acceso Enterprise y usan OAuth 2.0 App-Only para la autenticación.

Por ejemplo: puedes usar el endpoint de recuentos de Posts de todo el archivo para ver la cantidad de Posts con el hashtag #SOSHurricaneHarvey por día entre agosto y septiembre de 2017.

Nota: El endpoint de recuentos pagina en intervalos de 31 días por respuesta. Por ejemplo, al establecer una granularidad de día, se devolverá el recuento de resultados por día durante 31 días por página. Al establecer una granularidad de hora, se devolverá el recuento de resultados por hora durante 744 horas (31 días × 24 horas) por página. Si no especificas la granularidad ni el período de tiempo, este endpoint proporciona recuentos de Posts para una query por hora durante los últimos 30 días.

Guía rápida

Código de muestra

Abrir en Postman

Probar con API Explorer