Conteos recientes de Publicaciones

Esta guía te explica cómo obtener los recuentos de Publicaciones (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 recuentos recientes de Publicaciones

Crear una consulta

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

from:XDevelopers

Realizar 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")

# Obtener recuentos recientes de Publicaciones
response = client.posts.count_recent(
    query="from:XDevelopers",
    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 recientes de Publicaciones
const response = await client.posts.countRecent({
  query: "from:XDevelopers",
  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": "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

# Obtener 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")

# Obtener 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" });

// Obtener 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")

# Obtener 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"Publicaciones totales: {response.meta.total_tweet_count}")

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

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

// Obtener 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(`Publicaciones totales: ${response.meta?.total_tweet_count}`);

Parámetros comunes

Parámetro	Descripción	Valor predeterminado
`query`	Consulta de búsqueda (obligatorio)	—
`granularity`	Tamaño del intervalo temporal	`hour`
`start_time`	Marca temporal más antigua (ISO 8601)	Hace 7 días
`end_time`	Marca temporal más reciente (ISO 8601)	Ahora

Próximos pasos

Recuentos del archivo completo

Obtén recuentos históricos de Publicaciones

Crea una consulta

Domina la sintaxis de 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 recientes de Publicaciones

Obtener recuentos recientes de Publicaciones

Opciones de granularidad

Filtrar por rango de tiempo

Parámetros comunes

Próximos pasos

Recuentos del archivo completo

Crea una consulta

Referencia de la API