Conteo de Publicaciones

Los endpoints de recuento de Publicaciones devuelven el volumen de Publicaciones que coinciden con una consulta a lo largo del tiempo, sin devolver las Publicaciones en sí. Utiliza estos endpoints para analizar tendencias, comprender el tamaño de la conversación y perfeccionar las consultas antes de realizar búsquedas.

Descripción general

Análisis de volumen

Crea líneas de tendencia y visualizaciones que muestren el volumen de Publicaciones a lo largo del tiempo

Refinamiento de consultas

Estima el tamaño de los resultados antes de ejecutar consultas de búsqueda completas

Detección de eventos

Identifica cuándo las conversaciones alcanzan su punto máximo durante eventos

Investigación eficiente

Comprende la escala de la conversación sin tener que recuperar todas las Publicaciones

Endpoints

Endpoint	Descripción	Acceso
GET `/2/tweets/counts/recent`	Recuento de Publicaciones de los últimos 7 días	Todos los desarrolladores
GET `/2/tweets/counts/all`	Recuento de Publicaciones del archivo completo	Pago por uso, Enterprise

Opciones de granularidad

Especifica cómo se agrupan los recuentos usando el parámetro granularity:

Granularidad	Descripción	Caso de uso
`minute`	Recuentos por minuto	Monitoreo en tiempo real
`hour`	Recuentos por hora (predeterminado)	Análisis diario
`day`	Recuentos por día	Tendencias a largo plazo

Recuentos recientes

Obtén el recuento de Publicaciones de los últimos 7 días. Disponible para todos los desarrolladores.

Características

Recuentos agrupados por minuto, hora o día
Los mismos operadores de consulta que la búsqueda reciente
Longitud máxima de la consulta: 512 caracteres

Ejemplo de respuesta

{
  "data": [
    { "start": "2024-01-15T00:00:00.000Z", "end": "2024-01-15T01:00:00.000Z", "tweet_count": 1523 },
    { "start": "2024-01-15T01:00:00.000Z", "end": "2024-01-15T02:00:00.000Z", "tweet_count": 1247 },
    { "start": "2024-01-15T02:00:00.000Z", "end": "2024-01-15T03:00:00.000Z", "tweet_count": 892 }
  ],
  "meta": {
    "total_tweet_count": 3662
  }
}

Inicio rápido

Realiza tu primera solicitud de recuentos recientes

Referencia de la API

Documentación completa del endpoint

Conteos del archivo completo

Cuenta Publicaciones del archivo completo desde 2006.

La función de conteos del archivo completo está disponible para clientes de pago por uso y clientes Enterprise.

Características

Contar Publicaciones históricas de cualquier período de tiempo
Todos los operadores de consulta disponibles
Longitud máxima de la consulta: 1.024 caracteres (4.096 para Enterprise)

Paginación

Los resultados se paginan en intervalos de 31 días por respuesta:

Granularidad diaria: 31 días por página
Granularidad por hora: 744 horas (31 días) por página
Granularidad por minuto: 44 640 minutos (31 días) por página

Inicio rápido

Realiza tu primera solicitud de conteos de archivo completo

Referencia de la API

Documentación completa del endpoint

Operadores de consulta

Los recuentos de Publicaciones utilizan la misma sintaxis de consulta que los endpoints de búsqueda:

python lang:en -is:retweet

Crear una consulta

Aprende la sintaxis y los operadores de consulta

Notas importantes

Conteos frente a resultados de búsquedaEs posible que los conteos no coincidan exactamente con los resultados de búsqueda. Los endpoints de búsqueda aplican filtros de cumplimiento adicionales que los endpoints de conteo no aplican.

Primeros pasos

Requisitos previos

Una cuenta de desarrollador aprobada
Un Project y App en la Consola de desarrollador
El Bearer Token de tu App

Inicio rápido de recuentos recientes

Cuenta publicaciones de los últimos 7 días

Inicio rápido de archivo completo

Cuenta publicaciones históricas

Guía de integración

Conceptos clave y prácticas recomendadas

Código de ejemplo

Ejemplos de código funcional