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

# Récupérer les statistiques d’une Publication

> Récupère les données analytiques pour les Publications spécifiées dans un intervalle de temps donné.



## OpenAPI

````yaml /fr/openapi.json GET /2/tweets/analytics
openapi: 3.0.0
info:
  description: Points de terminaison disponibles dans X API v2
  version: '2.157'
  title: X API v2
  termsOfService: https://developer.x.com/en/developer-terms/agreement-and-policy.html
  contact:
    name: X Developers
    url: https://developer.x.com/
  license:
    name: X Developer Agreement and Policy
    url: https://developer.x.com/en/developer-terms/agreement-and-policy.html
servers:
  - description: X API
    url: https://api.x.com
security: []
tags:
  - name: Account Activity
    description: >-
      Points de terminaison pour la récupération et la gestion des abonnements
      AAA
    externalDocs:
      description: En savoir plus
      url: >-
        https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/account-activity
  - name: Bookmarks
    description: >-
      Points de terminaison permettant de récupérer et de gérer les signets d’un
      utilisateur
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/bookmarks
  - name: Compliance
    description: >-
      Points de terminaison pour garantir la conformité des données X dans vos
      systèmes
    externalDocs:
      description: En savoir plus
      url: >-
        https://developer.twitter.com/en/docs/twitter-api/compliance/batch-tweet/introduction
  - name: Connections
    description: Points de terminaison pour les connexions de flux en continu
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com/en/docs/x-api/connections
  - name: Direct Messages
    description: >-
      Points de terminaison permettant de récupérer et de gérer les Direct
      Messages
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/direct-messages
  - name: General
    description: Points de terminaison divers pour des fonctionnalités générales de l’API
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api
  - name: Lists
    description: Points de terminaison pour la récupération et la gestion des Listes
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/lists
  - name: Media
    description: Points de terminaison pour les médias
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: MediaUpload
    description: Points de terminaison pour le téléversement de médias
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: News
    description: Point de terminaison pour récupérer des articles d’actualité
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/news
  - name: Spaces
    description: Points de terminaison pour la récupération et la gestion des Spaces
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/spaces
  - name: Stream
    description: Points de terminaison pour le streaming
    externalDocs:
      description: En savoir plus
      url: https://developer.x.com
  - name: Tweets
    description: >-
      Points de terminaison pour la récupération, la recherche et la
      modification de Tweets
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/tweets/lookup
  - name: Users
    description: >-
      Points de terminaison pour la récupération et la gestion des relations des
      utilisateurs
    externalDocs:
      description: En savoir plus
      url: https://developer.twitter.com/en/docs/twitter-api/users/lookup
paths:
  /2/tweets/analytics:
    get:
      tags:
        - Tweets
      summary: Récupérer les statistiques d’une Publication
      description: >-
        Récupère les données analytiques pour les Publications spécifiées dans
        un intervalle de temps donné.
      operationId: getPostsAnalytics
      parameters:
        - name: ids
          in: query
          description: >-
            Une liste de valeurs d’identifiants (id) de Publications, séparées
            par des virgules. Jusqu’à 100 valeurs sont autorisées dans une seule
            requête.
          required: true
          schema:
            type: array
            minItems: 1
            maxItems: 100
            items:
              $ref: '#/components/schemas/TweetId'
          explode: false
          style: form
        - name: end_time
          in: query
          description: >-
            YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC qui représente la fin de
            l’intervalle de temps.
          required: true
          example: '2021-02-01T18:40:40.000Z'
          schema:
            type: string
            format: date-time
          style: form
        - name: start_time
          in: query
          description: >-
            YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC représentant le début de
            l’intervalle de temps.
          required: true
          example: '2021-02-01T18:40:40.000Z'
          schema:
            type: string
            format: date-time
          style: form
        - name: granularity
          in: query
          description: La granularité des résultats de comptage de recherche.
          required: true
          schema:
            type: string
            enum:
              - hourly
              - daily
              - weekly
              - total
            default: total
          style: form
        - $ref: '#/components/parameters/AnalyticsFieldsParameter'
      responses:
        '200':
          description: La requête a réussi.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Analytics'
        default:
          description: La requête a échoué.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
        - OAuth2UserToken:
            - tweet.read
            - users.read
        - UserToken: []
components:
  schemas:
    TweetId:
      type: string
      description: >-
        Identifiant unique de ce Tweet. Il est renvoyé sous forme de chaîne de
        caractères afin d’éviter les complications avec les langages et outils
        qui ne gèrent pas les entiers de très grande taille.
      pattern: ^[0-9]{1,19}$
      example: '1346889436626259968'
    Analytics:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                $ref: '#/components/schemas/TweetId'
              timestamped_metrics:
                type: array
                title: Timestamped Metrics
                description: >-
                  Tableau contenant les données de métriques et les horodatages
                  associés.
                items:
                  $ref: '#/components/schemas/TimestampedMetrics'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/Problem'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Problem:
      type: object
      description: >-
        Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807
        (https://tools.ietf.org/html/rfc7807).
      required:
        - type
        - title
      properties:
        detail:
          type: string
        status:
          type: integer
        title:
          type: string
        type:
          type: string
      discriminator:
        propertyName: type
        mapping:
          about:blank:
            $ref: '#/components/schemas/GenericProblem'
          https://api.twitter.com/2/problems/client-disconnected:
            $ref: '#/components/schemas/ClientDisconnectedProblem'
          https://api.twitter.com/2/problems/client-forbidden:
            $ref: '#/components/schemas/ClientForbiddenProblem'
          https://api.twitter.com/2/problems/conflict:
            $ref: '#/components/schemas/ConflictProblem'
          https://api.twitter.com/2/problems/disallowed-resource:
            $ref: '#/components/schemas/DisallowedResourceProblem'
          https://api.twitter.com/2/problems/duplicate-rules:
            $ref: '#/components/schemas/DuplicateRuleProblem'
          https://api.twitter.com/2/problems/invalid-request:
            $ref: '#/components/schemas/InvalidRequestProblem'
          https://api.twitter.com/2/problems/invalid-rules:
            $ref: '#/components/schemas/InvalidRuleProblem'
          https://api.twitter.com/2/problems/noncompliant-rules:
            $ref: '#/components/schemas/NonCompliantRulesProblem'
          https://api.twitter.com/2/problems/not-authorized-for-field:
            $ref: '#/components/schemas/FieldUnauthorizedProblem'
          https://api.twitter.com/2/problems/not-authorized-for-resource:
            $ref: '#/components/schemas/ResourceUnauthorizedProblem'
          https://api.twitter.com/2/problems/operational-disconnect:
            $ref: '#/components/schemas/OperationalDisconnectProblem'
          https://api.twitter.com/2/problems/resource-not-found:
            $ref: '#/components/schemas/ResourceNotFoundProblem'
          https://api.twitter.com/2/problems/resource-unavailable:
            $ref: '#/components/schemas/ResourceUnavailableProblem'
          https://api.twitter.com/2/problems/rule-cap:
            $ref: '#/components/schemas/RulesCapProblem'
          https://api.twitter.com/2/problems/streaming-connection:
            $ref: '#/components/schemas/ConnectionExceptionProblem'
          https://api.twitter.com/2/problems/unsupported-authentication:
            $ref: '#/components/schemas/UnsupportedAuthenticationProblem'
          https://api.twitter.com/2/problems/usage-capped:
            $ref: '#/components/schemas/UsageCapExceededProblem'
    TimestampedMetrics:
      type: object
      properties:
        metrics:
          $ref: '#/components/schemas/Metrics'
        timestamp:
          type: string
          title: Timestamp
          description: "Horodatage au format ISO\_8601"
          example: '2025-03-17T06:30:00Z'
    GenericProblem:
      description: >-
        Problème générique ne contenant aucune information supplémentaire
        au-delà de celle fournie par le code d’état HTTP.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientDisconnectedProblem:
      description: Votre client a été déconnecté.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ClientForbiddenProblem:
      description: >-
        Un problème indiquant que votre client n’est pas autorisé à effectuer
        cette requête.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            reason:
              type: string
              enum:
                - official-client-forbidden
                - client-not-enrolled
            registration_url:
              type: string
              format: uri
    ConflictProblem:
      description: >-
        Vous ne pouvez pas créer de nouvelle tâche si une tâche est déjà en
        cours.
      allOf:
        - $ref: '#/components/schemas/Problem'
    DisallowedResourceProblem:
      description: >-
        Objet Problem qui indique que la ressource demandée enfreint les
        principes de cette API.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_id
            - resource_type
            - section
          properties:
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    DuplicateRuleProblem:
      description: La règle que vous avez soumise est un doublon.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            id:
              type: string
            value:
              type: string
    InvalidRequestProblem:
      description: Un Problem qui indique que cette requête est invalide.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            errors:
              type: array
              minItems: 1
              items:
                type: object
                properties:
                  message:
                    type: string
                  parameters:
                    type: object
                    additionalProperties:
                      type: array
                      items:
                        type: string
    InvalidRuleProblem:
      description: La règle que vous avez soumise est invalide.
      allOf:
        - $ref: '#/components/schemas/Problem'
    NonCompliantRulesProblem:
      description: >-
        Un Problem indiquant que l'ensemble de règles de l'utilisateur n'est pas
        conforme.
      allOf:
        - $ref: '#/components/schemas/Problem'
    FieldUnauthorizedProblem:
      description: >-
        Un problème indiquant que vous n’êtes pas autorisé à voir un champ
        particulier d’un Tweet, d’un utilisateur, etc.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - resource_type
            - field
            - section
          properties:
            field:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
    ResourceUnauthorizedProblem:
      description: >-
        Un problème indiquant que vous n’êtes pas autorisé à voir un Tweet, un
        utilisateur, etc. donné.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - value
            - resource_id
            - resource_type
            - section
            - parameter
          properties:
            parameter:
              type: string
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            section:
              type: string
              enum:
                - data
                - includes
            value:
              type: string
    OperationalDisconnectProblem:
      description: Vous avez été déconnecté pour des raisons opérationnelles.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            disconnect_type:
              type: string
              enum:
                - OperationalDisconnect
                - UpstreamOperationalDisconnect
                - ForceDisconnect
                - UpstreamUncleanDisconnect
                - SlowReader
                - InternalError
                - ClientApplicationStateDegraded
                - InvalidRules
    ResourceNotFoundProblem:
      description: >-
        Un Problem qui indique qu’un Tweet, un utilisateur, etc. donné n’existe
        pas.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - value
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
            value:
              type: string
              description: La valeur sera conforme au schéma du champ.
    ResourceUnavailableProblem:
      description: >-
        Un problème indiquant qu’un Tweet, un utilisateur, etc. donné n’est pas
        disponible pour vous.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          required:
            - parameter
            - resource_id
            - resource_type
          properties:
            parameter:
              type: string
              minLength: 1
            resource_id:
              type: string
            resource_type:
              type: string
              enum:
                - user
                - tweet
                - media
                - list
                - space
    RulesCapProblem:
      description: Vous avez dépassé le nombre maximal de règles autorisées.
      allOf:
        - $ref: '#/components/schemas/Problem'
    ConnectionExceptionProblem:
      description: >-
        Un objet Problem indiquant qu’il y a un dysfonctionnement avec la
        connexion.
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            connection_issue:
              type: string
              enum:
                - TooManyConnections
                - ProvisioningSubscription
                - RuleConfigurationIssue
                - RulesInvalidIssue
    UnsupportedAuthenticationProblem:
      description: >-
        Un Problem indiquant que le mécanisme d’authentification utilisé n’est
        pas pris en charge.
      allOf:
        - $ref: '#/components/schemas/Problem'
    UsageCapExceededProblem:
      description: Un Problem qui indique qu’un plafond d’utilisation a été dépassé
      allOf:
        - $ref: '#/components/schemas/Problem'
        - type: object
          properties:
            period:
              type: string
              enum:
                - Daily
                - Monthly
            scope:
              type: string
              enum:
                - Account
                - Product
    Metrics:
      type: object
      properties:
        app_install_attempts:
          type: integer
          title: App Install Attempts
          description: Suit le nombre de tentatives d’installation de l’App.
        app_opens:
          type: integer
          title: App Opens
          description: Suit le nombre d’ouvertures de l’App.
        detail_expands:
          type: integer
          title: Detail Expands
          description: Suit le nombre d’extensions de la vue Détails.
        email_tweet:
          type: integer
          title: Email Tweet
          description: Suit le nombre de partages du Tweet par e‑mail
        engagements:
          type: integer
          title: Engagements
          description: Suit le nombre total d’engagements
        follows:
          type: integer
          title: Follows
          description: Suit le nombre d’abonnements
        hashtag_clicks:
          type: integer
          title: Hashtag Clicks
          description: Suit le nombre de clics sur le hashtag
        impressions:
          type: integer
          title: Impressions
          description: Suit le nombre d’impressions
        likes:
          type: integer
          title: Likes
          description: Suit le nombre de mentions J’aime
        link_clicks:
          type: integer
          title: Link Clicks
          description: Suit le nombre de clics sur le lien
        media_engagements:
          type: integer
          title: Media Engagements
          description: Suit le nombre d’interactions avec les médias
        media_views:
          type: integer
          title: Media Views
          description: Suit le nombre de vues des médias
        permalink_clicks:
          type: integer
          title: Permalink Clicks
          description: Suit le nombre de clics sur le permalien
        profile_visits:
          type: integer
          title: Profile Visits
          description: Suit le nombre de visites du profil
        quote_tweets:
          type: integer
          title: Quote Tweets
          description: Suit le nombre de Tweets cités
        replies:
          type: integer
          title: Replies
          description: Suit le nombre de réponses
        retweets:
          type: integer
          title: Retweets
          description: Suit le nombre de Retweets
        url_clicks:
          type: integer
          title: URL Clicks
          description: Suit le nombre de clics sur l’URL
        user_profile_clicks:
          type: integer
          title: User Profile Clicks
          description: Suit le nombre de clics sur le profil de l’utilisateur
  parameters:
    AnalyticsFieldsParameter:
      name: analytics.fields
      in: query
      description: Une liste de champs Analytics à afficher, séparés par des virgules.
      required: false
      schema:
        type: array
        description: Les champs disponibles pour un objet Analytics.
        minItems: 1
        uniqueItems: true
        items:
          type: string
          enum:
            - app_install_attempts
            - app_opens
            - bookmarks
            - detail_expands
            - email_tweet
            - engagements
            - follows
            - hashtag_clicks
            - id
            - impressions
            - likes
            - media_views
            - permalink_clicks
            - quote_tweets
            - replies
            - retweets
            - shares
            - timestamp
            - unfollows
            - unlikes
            - url_clicks
            - user_profile_clicks
        example:
          - app_install_attempts
          - app_opens
          - bookmarks
          - detail_expands
          - email_tweet
          - engagements
          - follows
          - hashtag_clicks
          - id
          - impressions
          - likes
          - media_views
          - permalink_clicks
          - quote_tweets
          - replies
          - retweets
          - shares
          - timestamp
          - unfollows
          - unlikes
          - url_clicks
          - user_profile_clicks
      explode: false
      style: form
  securitySchemes:
    OAuth2UserToken:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://api.x.com/2/oauth2/authorize
          tokenUrl: https://api.x.com/2/oauth2/token
          scopes:
            block.read: View accounts you have blocked.
            bookmark.read: Read your bookmarked Posts.
            bookmark.write: Create and delete your bookmarks.
            dm.read: Read all your Direct Messages.
            dm.write: Send and manage your Direct Messages.
            follows.read: View accounts you follow and accounts following you.
            follows.write: Follow and unfollow accounts on your behalf.
            like.read: View Posts you have liked and likes you can see.
            like.write: Like and unlike Posts on your behalf.
            list.read: >-
              View Lists, members, and followers of Lists you created or are a
              member of, including private Lists.
            list.write: Create and manage Lists on your behalf.
            media.write: Upload media, such as photos and videos, on your behalf.
            mute.read: View accounts you have muted.
            mute.write: Mute and unmute accounts on your behalf.
            offline.access: Request a refresh token for the app.
            space.read: View all Spaces you have access to.
            timeline.read: >-
              View all Custom Timelines you can see, including public Custom
              Timelines from other developers.
            tweet.moderate.write: Hide and unhide replies to your Posts.
            tweet.read: >-
              View all Posts you can see, including those from protected
              accounts.
            tweet.write: Post and repost on your behalf.
            users.read: View any account you can see, including protected accounts.
    UserToken:
      type: http
      scheme: OAuth

````