Passer au contenu principal
Les endpoints de comptage de Publications renvoient le nombre de Publications correspondant à une requête au fil du temps, sans renvoyer les Publications elles-mêmes. Utilisez ces endpoints pour analyser les tendances, comprendre l’ampleur des conversations et affiner vos requêtes avant d’effectuer une recherche.

​
Vue d’ensemble

Analyse du volume

Créez des courbes de tendance et des visualisations montrant le volume de Publications au fil du temps

Affinage des requêtes

Estimez la taille des résultats avant d’exécuter des requêtes de recherche complètes

Détection d’événements

Identifiez les moments où les conversations ont atteint un pic autour d’événements

Recherche efficace

Comprenez l’ampleur des conversations sans avoir à récupérer toutes les Publications

​
Endpoints

EndpointDescriptionAccess
GET /2/tweets/counts/recentNombre de Publications des 7 derniers joursTous les développeurs
GET /2/tweets/counts/allNombre de Publications de l’archive complèteFacturation à l’utilisation, Enterprise

​
Options de granularité

Indiquez comment les comptages sont regroupés à l’aide du paramètre granularity :
GranularitéDescriptionCas d’utilisation
minuteComptages par minuteSurveillance en temps réel
hourComptages par heure (valeur par défaut)Analyse quotidienne
dayComptages par jourTendances à long terme

​
Décomptes récents

Calculez le nombre de Publications des 7 derniers jours. Disponible pour tous les développeurs.

​
Fonctionnalités

  • Comptages regroupés par minute, heure ou jour
  • Mêmes opérateurs de requête que pour la recherche récente
  • Longueur de requête maximale de 512 caractères

​
Exemple de réponse

{
  "data": [
    { "start": "2024-01-15T00:00:00.000Z", "end": "2024-01-15T01:00:00.000Z", "tweet_count": 1523 },
    { "start": "2024-01-15T01:00:00.000Z", "end": "2024-01-15T02:00:00.000Z", "tweet_count": 1247 },
    { "start": "2024-01-15T02:00:00.000Z", "end": "2024-01-15T03:00:00.000Z", "tweet_count": 892 }
  ],
  "meta": {
    "total_tweet_count": 3662
  }
}

Démarrage rapide

Effectuez votre première requête de comptage de Publications récentes

Référence de l’API

Documentation complète de l’endpoint

​
Décomptes sur l’archive complète

Obtenez le nombre de Publications depuis l’archive complète remontant jusqu’à 2006.
Les décomptes sur l’archive complète sont disponibles pour les clients à l’usage et les clients Enterprise.

​
Fonctionnalités

  • Compter les Publications historiques sur n’importe quelle période
  • Tous les opérateurs de requête sont disponibles
  • Longueur de requête pouvant atteindre 1 024 caractères (4 096 pour Enterprise)
Les résultats sont paginés par périodes de 31 jours par réponse :
  • Granularité jour : 31 jours par page
  • Granularité heure : 744 heures (31 jours) par page
  • Granularité minute : 44 640 minutes (31 jours) par page

Démarrage rapide

Effectuez votre première requête de comptage d’archive complète

Référence de l’API

Documentation complète de l’endpoint

​
Opérateurs de requête

Les décomptes de Publications utilisent la même syntaxe de requête que les points de terminaison de recherche : 
python lang:en -is:retweet

Créer une requête

Apprenez la syntaxe des requêtes et les opérateurs

​
Remarques importantes

Comptages vs résultats de rechercheLes comptages peuvent ne pas correspondre exactement aux résultats de recherche. Les endpoints de recherche appliquent un filtrage de conformité supplémentaire que les endpoints de comptage n’appliquent pas.

​
Pour commencer

Prérequis

Démarrage rapide : décomptes récents

Comptez les Publications des 7 derniers jours

Démarrage rapide : archive complète

Comptez les Publications historiques

Guide d’intégration

Concepts clés et bonnes pratiques

Exemples de code

Exemples de code fonctionnels