Statistiques

Accédez aux statistiques d’engagement pour les Publications et les médias

X API fournit des statistiques d’engagement pour les Publications et les médias. Accédez aux statistiques publiques avec n’importe quel mode d’authentification, ou aux statistiques privées pour votre propre contenu avec l’authentification utilisateur.

---

Types de métriques

Type	Authentification	Description
Publique	Jeton Bearer	Visibles par tous (mentions J’aime, republications, réponses)
Non publique	Contexte utilisateur	Métriques privées (impressions, clics)
Organique	Contexte utilisateur	Métriques issues de vues non sponsorisées
Promue	Contexte utilisateur	Métriques issues de vues d’annonces

Limite de 30 jours : les métriques non publiques, organiques et promues ne sont disponibles que pour les publications créées au cours des 30 derniers jours.

---

Mesures disponibles

Métriques de Publication

Métrique	Type	Chemin de champ
Reposts	Public	public_metrics.retweet_count
Citations	Public	public_metrics.quote_count
J’aime	Public	public_metrics.like_count
Réponses	Public	public_metrics.reply_count
Impressions	Non public	non_public_metrics.impression_count
Clics sur l’URL	Non public	non_public_metrics.url_link_clicks
Clics sur le profil	Non public	non_public_metrics.user_profile_clicks

Statistiques des médias (vidéos)

Métrique	Type	Chemin du champ
Vues	Publique	public_metrics.view_count
Lecture 0 %	Non publique	non_public_metrics.playback_0_count
Lecture 25 %	Non publique	non_public_metrics.playback_25_count
Lecture 50 %	Non publique	non_public_metrics.playback_50_count
Lecture 75 %	Non publique	non_public_metrics.playback_75_count
Lecture 100 %	Non publique	non_public_metrics.playback_100_count

---

Demander des métriques

Métriques publiques (tout type d’authentification)

curl "https://api.x.com/2/tweets/1234567890?tweet.fields=public_metrics" \
  -H "Authorization: Bearer $TOKEN"

Réponse :

{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "public_metrics": {
      "retweet_count": 50,
      "reply_count": 12,
      "like_count": 234,
      "quote_count": 5
    }
  }
}

Indicateurs privés (contexte utilisateur)

Nécessite OAuth 1.0a ou OAuth 2.0 avec contexte utilisateur pour vos Publications :

curl "https://api.x.com/2/tweets/1234567890?tweet.fields=non_public_metrics,organic_metrics" \
  -H "Authorization: OAuth oauth_consumer_key=...,oauth_token=..."

Réponse :

{
  "data": {
    "id": "1234567890",
    "text": "Hello world!",
    "non_public_metrics": {
      "impression_count": 5432,
      "url_link_clicks": 89,
      "user_profile_clicks": 156
    },
    "organic_metrics": {
      "impression_count": 5432,
      "like_count": 234,
      "reply_count": 12,
      "retweet_count": 50,
      "url_link_clicks": 89,
      "user_profile_clicks": 156
    }
  }
}

---

Métriques vidéo

Pour les métriques de lecture vidéo, utilisez l’extension media :

curl "https://api.x.com/2/tweets/1234567890?\
tweet.fields=attachments&\
expansions=attachments.media_keys&\
media.fields=public_metrics,non_public_metrics" \
  -H "Authorization: OAuth ..."

Réponse :

{
  "data": {
    "id": "1234567890",
    "text": "Check out this video!",
    "attachments": {
      "media_keys": ["13_9876543210"]
    }
  },
  "includes": {
    "media": [{
      "media_key": "13_9876543210",
      "type": "video",
      "public_metrics": {
        "view_count": 12543
      },
      "non_public_metrics": {
        "playback_0_count": 12543,
        "playback_25_count": 9876,
        "playback_50_count": 7654,
        "playback_75_count": 5432,
        "playback_100_count": 3210
      }
    }]
  }
}

---

Statistiques organiques vs sponsorisées

Si une Publication a été promue en tant que publicité, les statistiques sont réparties entre vues organiques et sponsorisées :

Contexte	Description
Organic	Statistiques issues des vues normales du fil
Promoted	Statistiques issues des impressions publicitaires payantes
Public	Total combiné (organique + sponsorisé)

Demandez les deux pour voir la répartition :

tweet.fields=public_metrics,organic_metrics,promoted_metrics

---

Définitions des métriques

Impressions

Nombre de fois où la publication est apparue sur l’écran d’un utilisateur. Non unique : si le même utilisateur la voit deux fois, cela compte comme deux impressions.

Nombre de republications

Nombre de republications (retweets). N’inclut pas les publications citées.

Nombre de citations

Nombre de publications citées (republications avec commentaire). Ces dernières sont toujours organiques.

Vues vidéo

Cumulé sur l’ensemble des publications contenant la vidéo. Une vidéo republicée dans plusieurs publications ne dispose que d’un seul total de vues.

Quartiles de lecture

Nombre d’utilisateurs uniques ayant regardé chaque pourcentage de la vidéo. Utile pour comprendre les taux d’abandon.

---

Résumé des prérequis

Champ de métrique	Authentification requise
public_metrics	Jeton Bearer (n’importe lequel)
non_public_metrics	Contexte utilisateur (publications appartenant à l’utilisateur uniquement)
organic_metrics	Contexte utilisateur (publications appartenant à l’utilisateur uniquement)
promoted_metrics	Contexte utilisateur (publications sponsorisées uniquement)

---

Prochaines étapes

Dictionnaire de données

Référence complète des champs.

Authentification

Configurez l’authentification avec contexte utilisateur.