Conteos de Publicaciones del archivo completo

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 previosAntes 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

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

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`

Realizar la solicitud

cURL

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener recuentos de Publicaciones del archivo completo
response = client.posts.count_all(
    query="from:XDevelopers",
    start_time="2020-01-01T00:00:00Z",
    end_time="2020-12-31T23:59:59Z",
    granularity="day"
)

for bucket in response.data:
    print(f"{bucket.start}: {bucket.tweet_count} Publicaciones")

print(f"Total: {response.meta.total_tweet_count}")

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener recuentos de Publicaciones del archivo completo
const response = await client.posts.countAll({
  query: "from:XDevelopers",
  startTime: "2020-01-01T00:00:00Z",
  endTime: "2020-12-31T23:59:59Z",
  granularity: "day",
});

response.data?.forEach((bucket) => {
  console.log(`${bucket.start}: ${bucket.tweet_count} Publicaciones`);
});

console.log(`Total: ${response.meta?.total_tweet_count}`);

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

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"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener recuentos con paginación
next_token = None

while True:
    response = client.posts.count_all(
        query="from:XDevelopers",
        start_time="2015-01-01T00:00:00Z",
        end_time="2020-12-31T23:59:59Z",
        granularity="day",
        next_token=next_token
    )
    
    for bucket in response.data:
        print(f"{bucket.start}: {bucket.tweet_count}")
    
    next_token = response.meta.next_token
    if not next_token:
        break

import { Client } from "@xdevplatform/xdk";

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

// Obtener recuentos con paginación
let nextToken = undefined;

do {
  const response = await client.posts.countAll({
    query: "from:XDevelopers",
    startTime: "2015-01-01T00:00:00Z",
    endTime: "2020-12-31T23:59:59Z",
    granularity: "day",
    nextToken,
  });

  response.data?.forEach((bucket) => {
    console.log(`${bucket.start}: ${bucket.tweet_count}`);
  });

  nextToken = response.meta?.next_token;
} while (nextToken);

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

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Conteos de Publicaciones del archivo completo

Obtener recuentos de Publicaciones del archivo completo

Opciones de granularidad

Paginar los resultados

Diferencias clave con los recuentos recientes

Parámetros comunes

Próximos pasos

Conteos recientes

Crea una consulta

Referencia de la API