Décomptes de publications de l’archive complète

Ce guide vous explique comment obtenir le nombre de Publications historiques jusqu’en mars 2006.

Le comptage de Publications sur l’intégralité de l’archive nécessite un accès Self-serve ou Enterprise.

PrérequisAvant de commencer, vous aurez besoin :

D’un compte développeur avec un accès Self-serve ou Enterprise
Du jeton Bearer de votre App

Obtenir le nombre de Publications pour l’intégralité des archives

Créer une requête

Utilisez la même syntaxe de requête que pour la recherche dans l’intégralité des archives. Par exemple, pour compter les Publications provenant de @XDevelopers :

from:XDevelopers

Définir une plage temporelle

Indiquez start_time et end_time pour rechercher des périodes historiques spécifiques :

Paramètre	Format	Exemple
`start_time`	ISO 8601	`2020-01-01T00:00:00Z`
`end_time`	ISO 8601	`2020-12-31T23:59:59Z`

Effectuer la requête

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

# Obtenir le nombre de Publications pour l’intégralité des archives
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} Publications")

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

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

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

// Obtenir le nombre de Publications pour l’intégralité des archives
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} Publications`);
});

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

Examiner la réponse

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

Options de granularité

Contrôlez la manière dont les décomptes sont regroupés :

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

Paginer les résultats

Pour des plages temporelles étendues, utilisez le next_token de la réponse :

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

# Récupérer les dénombrements avec pagination
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" });

// Récupérer les dénombrements avec pagination
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);

Principales différences par rapport aux décomptes récents

Fonctionnalité	Recent Counts	Full-Archive Counts
Plage temporelle	7 derniers jours	De mars 2006 à aujourd’hui
Accès requis	Tous les développeurs	Paiement à l’usage, Enterprise
Plage temporelle par défaut	7 derniers jours	30 derniers jours

Paramètres communs

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

Étapes suivantes

Décomptes récents

Obtenir les décomptes récents 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

Décomptes de publications de l’archive complète

Obtenir le nombre de Publications pour l’intégralité des archives

Options de granularité

Paginer les résultats

Principales différences par rapport aux décomptes récents

Paramètres communs

Étapes suivantes

Décomptes récents

Créer une requête

Référence de l’API