Passer au contenu principal
Ce guide vous explique comment obtenir le nombre de Publications (volume) pour les 7 derniers jours.
PrérequisAvant de commencer, vous aurez besoin de :

Obtenir le nombre de Publications récentes

1

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
2

Effectuer la requête

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

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
minuteComptages par minute
hourComptages par heure (valeur par défaut)
dayComptages 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"

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"

Paramètres communs

ParamètreDescriptionValeur par défaut
queryRequête de recherche (obligatoire)
granularityTaille de la plage temporellehour
start_timeHorodatage le plus ancien (ISO 8601)Il y a 7 jours
end_timeHorodatage 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