Nombre de Publications récentes

Ce guide vous explique comment obtenir le nombre de Publications (volume) pour les 7 derniers jours.

PrérequisAvant de commencer, vous aurez besoin de :

d’un compte développeur avec une App approuvée
du jeton Bearer de votre App

Obtenir le nombre de Publications récentes

Créer une requête

Utilisez la même syntaxe de requête que pour la recherche récente. Par exemple, pour compter les Publications de @XDevelopers :

from:XDevelopers

Effectuer la requête

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

# Obtenir le nombre de Publications récentes
response = client.posts.count_recent(
    query="from:XDevelopers",
    granularity="day"
)

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

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

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

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

// Obtenir le nombre de Publications récentes
const response = await client.posts.countRecent({
  query: "from:XDevelopers",
  granularity: "day",
});

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

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

Examiner la réponse

{
  "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
  }
}

Options de granularité

Contrôlez la façon dont les comptages sont regroupés :

Granularité	Description
`minute`	Comptages par minute
`hour`	Comptages par heure (valeur par défaut)
`day`	Comptages par jour

cURL

# Récupérer les comptages horaires
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")

# Récupérer les comptages horaires
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" });

// Récupérer les comptages horaires
const response = await client.posts.countRecent({
  query: "python lang:en",
  granularity: "hour",
});

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

Filtrer par plage temporelle

Limiter les décomptes à une période donnée :

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

# Récupérer les décomptes pour une plage temporelle spécifique
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" });

// Récupérer les décomptes pour une plage temporelle spécifique
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}`);

Paramètres communs

Paramètre	Description	Valeur par défaut
`query`	Requête de recherche (obligatoire)	—
`granularity`	Taille de la plage temporelle	`hour`
`start_time`	Horodatage le plus ancien (ISO 8601)	Il y a 7 jours
`end_time`	Horodatage le plus récent (ISO 8601)	Maintenant

Prochaines étapes

Décomptes de l’archive complète

Obtenez les décomptes historiques de Publications

Créer une requête

Maîtriser la syntaxe des requêtes

Référence de l’API

Documentation complète de l’endpoint

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Nombre de Publications récentes

Obtenir le nombre de Publications récentes

Options de granularité

Filtrer par plage temporelle

Paramètres communs

Prochaines étapes

Décomptes de l’archive complète

Créer une requête

Référence de l’API