Recent Post Counts

Esta guía te muestra cómo obtener recuentos de Posts (volumen) de los últimos 7 días.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
El Bearer Token de tu App

Obtener recent Post counts

Construye una consulta

Usa la misma sintaxis de consulta que recent search. Por ejemplo, para contar Posts de @XDevelopers:

from:XDevelopers

Realiza la solicitud

cURL

curl "https://api.x.com/2/tweets/counts/recent?\
query=from%3AXDevelopers&\
granularity=day" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtén recent Post counts
response = client.posts.count_recent(
    query="from:XDevelopers",
    granularity="day"
)

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

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

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

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

// Obtén recent Post counts
const response = await client.posts.countRecent({
  query: "from:XDevelopers",
  granularity: "day",
});

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

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

Revisa la respuesta

{
  "data": [
    {
      "end": "2024-01-16T00:00:00.000Z",
      "start": "2024-01-15T00:00:00.000Z",
      "tweet_count": 5
    },
    {
      "end": "2024-01-17T00:00:00.000Z",
      "start": "2024-01-16T00:00:00.000Z",
      "tweet_count": 3
    },
    {
      "end": "2024-01-18T00:00:00.000Z",
      "start": "2024-01-17T00:00:00.000Z",
      "tweet_count": 8
    }
  ],
  "meta": {
    "total_tweet_count": 16
  }
}

Opciones de granularidad

Controla cómo se agrupan los recuentos:

Granularity	Description
`minute`	Recuentos por minuto
`hour`	Recuentos por hora (predeterminado)
`day`	Recuentos por día

cURL

# Obtén recuentos por hora
curl "https://api.x.com/2/tweets/counts/recent?\
query=python%20lang%3Aen&\
granularity=hour" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtén recuentos por hora
response = client.posts.count_recent(
    query="python lang:en",
    granularity="hour"
)

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

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

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

// Obtén recuentos por hora
const response = await client.posts.countRecent({
  query: "python lang:en",
  granularity: "hour",
});

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

Filtrar por rango de tiempo

Limita los recuentos a un período de tiempo específico:

cURL

curl "https://api.x.com/2/tweets/counts/recent?\
query=from%3AXDevelopers&\
start_time=2024-01-10T00%3A00%3A00Z&\
end_time=2024-01-15T00%3A00%3A00Z&\
granularity=day" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtén los recuentos para un rango de tiempo específico
response = client.posts.count_recent(
    query="from:XDevelopers",
    start_time="2024-01-10T00:00:00Z",
    end_time="2024-01-15T00:00:00Z",
    granularity="day"
)

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

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

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

// Obtén los recuentos para un rango de tiempo específico
const response = await client.posts.countRecent({
  query: "from:XDevelopers",
  startTime: "2024-01-10T00:00:00Z",
  endTime: "2024-01-15T00:00:00Z",
  granularity: "day",
});

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

Parámetros comunes

Parameter	Description	Default
`query`	Consulta de búsqueda (obligatorio)	—
`granularity`	Tamaño del bucket de tiempo	`hour`
`start_time`	Timestamp más antiguo (ISO 8601)	Hace 7 días
`end_time`	Timestamp más reciente (ISO 8601)	Ahora

Próximos pasos

Full-archive counts

Obtén recuentos históricos de Posts

Construir una consulta

Domina la sintaxis de consulta

Referencia de la API

Documentación completa del endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Recent Post Counts

Obtener recent Post counts

Opciones de granularidad

Filtrar por rango de tiempo

Parámetros comunes

Próximos pasos

Full-archive counts

Construir una consulta

Referencia de la API

​Obtener recent Post counts

​Opciones de granularidad

​Filtrar por rango de tiempo

​Parámetros comunes

​Próximos pasos

Full-archive counts

Construir una consulta

Referencia de la API

Obtener recent Post counts

Opciones de granularidad

Filtrar por rango de tiempo

Parámetros comunes

Próximos pasos