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

Obtenez le volume historique de publications depuis 2006

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érequis

Avant 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

1. 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
   
2. 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

3. Effectuer la requête

   cURL

   shellscript

   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"
   
4. 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

shellscript

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"

---

​

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