Passer au contenu principal
L’endpoint Usage vous permet de surveiller votre consommation de l’API, y compris le nombre de Publications consommées. Suivez votre consommation de façon programmatique afin de maîtriser les coûts et de rester dans les limites prévues.

Vue d’ensemble

Utilisation des Publications

Suivre le nombre de Publications consommées

Répartition quotidienne

Afficher l’utilisation par jour

Niveau App

Surveiller l’utilisation de votre App

Endpoint

MethodEndpointDescription
GET/2/usage/tweetsRécupérer les données d’utilisation des publications

Données de la réponse

La réponse comprend les nombres quotidiens de consommation de Publications :
{
  "data": {
    "daily_project_usage": [
      {
        "date": "2024-01-15",
        "usage": [
          {
            "app_id": "12345678",
            "tweets_consumed": 15420
          }
        ]
      }
    ],
    "project_id": "1234567890",
    "project_cap": 10000000
  }
}

Champs

ChampDescription
daily_project_usageTableau des données d’utilisation quotidiennes
dateDate au format YYYY-MM-DD
app_idL’id de votre App
tweets_consumedPublications consommées ce jour-là
project_capVotre limite mensuelle de publications

Exemple de requête

curl "https://api.x.com/2/usage/tweets" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Cas d’usage

  • Suivi des coûts — Surveillez la consommation par rapport aux limites de votre offre
  • Alertes — Configurez des alertes à l’approche des limites
  • Optimisation — Identifiez les endpoints à forte consommation
  • Génération de rapports — Générez des rapports d’utilisation
Les ressources sont dédupliquées sur une période de 24 heures (UTC) : ainsi, demander plusieurs fois la même ressource au cours d’une journée ne donne lieu qu’à une seule facturation. En savoir plus sur la tarification →

Premiers pas

Prérequis

Référence de l’API

Documentation complète des points de terminaison

Console de développement

Afficher l’utilisation dans le tableau de bord