> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

***

<div id="metric-types">
  ## Types de métriques
</div>

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

<Note>
  **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.
</Note>

***

<div id="available-metrics">
  ## Mesures disponibles
</div>

<div id="post-metrics">
  ### Métriques de Publication
</div>

| 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` |

<div id="media-metrics-videos">
  ### Statistiques des médias (vidéos)
</div>

| 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` |

***

<div id="requesting-metrics">
  ## Demander des métriques
</div>

<div id="public-metrics-any-auth">
  ### Métriques publiques (tout type d'authentification)
</div>

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

Réponse :

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

<div id="private-metrics-user-context">
  ### Indicateurs privés (contexte utilisateur)
</div>

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

```bash theme={null}
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 :

```json theme={null}
{
  "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
    }
  }
}
```

***

<div id="video-metrics">
  ## Métriques vidéo
</div>

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

```bash theme={null}
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 :

```json theme={null}
{
  "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
      }
    }]
  }
}
```

***

<div id="organic-vs-promoted-metrics">
  ## Statistiques organiques vs sponsorisées
</div>

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 :

```bash theme={null}
tweet.fields=public_metrics,organic_metrics,promoted_metrics
```

***

<div id="metric-definitions">
  ## Définitions des métriques
</div>

<Accordion title="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.
</Accordion>

<Accordion title="Nombre de republications">
  Nombre de republications (retweets). N’inclut pas les publications citées.
</Accordion>

<Accordion title="Nombre de citations">
  Nombre de publications citées (republications avec commentaire). Ces dernières sont toujours organiques.
</Accordion>

<Accordion title="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.
</Accordion>

<Accordion title="Quartiles de lecture">
  Nombre d’utilisateurs uniques ayant regardé chaque pourcentage de la vidéo. Utile pour comprendre les taux d’abandon.
</Accordion>

***

<div id="requirements-summary">
  ## Résumé des prérequis
</div>

| 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)                |

***

<div id="next-steps">
  ## Prochaines étapes
</div>

<CardGroup cols={2}>
  <Card title="Dictionnaire de données" icon="book" href="/fr/x-api/fundamentals/data-dictionary">
    Référence complète des champs.
  </Card>

  <Card title="Authentification" icon="key" href="/fr/resources/fundamentals/authentication/overview">
    Configurez l'authentification avec contexte utilisateur.
  </Card>
</CardGroup>