Conteos de Publicaciones del archivo completo

Obtén el volumen histórico de Publicaciones hasta 2006

Esta guía te explica cómo obtener recuentos históricos de Publicaciones desde marzo de 2006.

Los recuentos de Publicaciones de archivo completo requieren acceso Self-serve o Enterprise.

Requisitos previos

Antes de comenzar, necesitarás:

• Una cuenta de desarrollador con acceso Self-serve o Enterprise
• El Bearer Token de tu App

---

​

Obtener recuentos de Publicaciones del archivo completo

1. Crear una consulta

   Usa la misma sintaxis de consulta que en la búsqueda en el archivo completo. Por ejemplo, para contar Publicaciones de @XDevelopers:

   from:XDevelopers
   
2. Definir un intervalo de tiempo

   Especifica start_time y end_time para buscar períodos históricos específicos:

   Parámetro	Formato	Ejemplo
   start_time	ISO 8601	2020-01-01T00:00:00Z
   end_time	ISO 8601	2020-12-31T23:59:59Z

3. Realizar la solicitud

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/counts/all?\
   query=from%3AXDevelopers&\
   start_time=2020-01-01T00%3A00%3A00Z&\
   end_time=2020-12-31T23%3A59%3A59Z&\
   granularity=day" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
4. Revisar la respuesta

   {
     "data": [
       {
         "end": "2020-01-02T00:00:00.000Z",
         "start": "2020-01-01T00:00:00.000Z",
         "tweet_count": 3
       },
       {
         "end": "2020-01-03T00:00:00.000Z",
         "start": "2020-01-02T00:00:00.000Z",
         "tweet_count": 5
       }
     ],
     "meta": {
       "total_tweet_count": 8
     }
   }
   

---

​

Opciones de granularidad

Controla cómo se agrupan los conteos:

Granularidad	Descripción
minute	Conteos por minuto
hour	Conteos por hora (predeterminado)
day	Conteos por día

---

​

Paginar los resultados

Para intervalos de tiempo amplios, utiliza el next_token de la respuesta:

cURL

shellscript

curl "https://api.x.com/2/tweets/counts/all?\
query=from%3AXDevelopers&\
start_time=2015-01-01T00%3A00%3A00Z&\
end_time=2020-12-31T23%3A59%3A59Z&\
granularity=day&\
next_token=abc123" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Diferencias clave con los recuentos recientes

Funcionalidad	Recuentos recientes	Recuentos de archivo completo
Intervalo de tiempo	Últimos 7 días	Desde marzo de 2006 hasta la fecha
Acceso requerido	Todos los desarrolladores	Pago por uso, Enterprise
Intervalo de tiempo predeterminado	Últimos 7 días	Últimos 30 días

---

​

Parámetros comunes

Parámetro	Descripción	Predeterminado
query	Consulta de búsqueda (requerida)	—
granularity	Tamaño del intervalo temporal	hour
start_time	Marca de tiempo más antigua (ISO 8601)	Hace 30 días
end_time	Marca de tiempo más reciente (ISO 8601)	Ahora
next_token	Token de paginación	—

---

​

Próximos pasos

Conteos recientes

Obtén conteos recientes de Publicaciones

Crea una consulta

Domina la sintaxis de las consultas

Referencia de la API

Documentación completa del endpoint