Saltar al contenido principal
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

EndpointDescripciónAcceso
GET /2/tweets/counts/recentRecuento de Publicaciones de los últimos 7 díasTodos los desarrolladores
GET /2/tweets/counts/allRecuento de Publicaciones del archivo completoPago por uso, Enterprise

​
Opciones de granularidad

Especifica cómo se agrupan los recuentos usando el parámetro granularity:
GranularidadDescripciónCaso de uso
minuteRecuentos por minutoMonitoreo en tiempo real
hourRecuentos por hora (predeterminado)Análisis diario
dayRecuentos por díaTendencias 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)
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

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