Passer au contenu principal
GET
/
2
/
tweets
/
analytics
Récupérer les statistiques d’une Publication
curl --request GET \
  --url https://api.x.com/2/tweets/analytics \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "1346889436626259968",
      "timestamped_metrics": [
        {
          "metrics": {
            "app_install_attempts": 123,
            "app_opens": 123,
            "detail_expands": 123,
            "email_tweet": 123,
            "engagements": 123,
            "follows": 123,
            "hashtag_clicks": 123,
            "impressions": 123,
            "likes": 123,
            "link_clicks": 123,
            "media_engagements": 123,
            "media_views": 123,
            "permalink_clicks": 123,
            "profile_visits": 123,
            "quote_tweets": 123,
            "replies": 123,
            "retweets": 123,
            "url_clicks": 123,
            "user_profile_clicks": 123
          },
          "timestamp": "2025-03-17T06:30:00Z"
        }
      ]
    }
  ],
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de requête

​
ids
string[]
requis

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 array length: 1 - 100 elements

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}$
​
end_time
string<date-time>
requis

YYYY-MM-DDTHH:mm:ssZ. L’horodatage UTC qui représente la fin de l’intervalle de temps.

​
start_time
string<date-time>
requis

YYYY-MM-DDTHH:mm:ssZ. Horodatage UTC représentant le début de l’intervalle de temps.

​
granularity
enum<string>
défaut:total
requis

La granularité des résultats de comptage de recherche.

Options disponibles:
hourly,
daily,
weekly,
total
​
analytics.fields
enum<string>[]

Une liste de champs Analytics à afficher, séparés par des virgules. Les champs disponibles pour un objet Analytics.

Minimum array length: 1
Options disponibles:
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
Exemple:
[
  "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"
]

Réponse

La requête a réussi.

​
data
object[]
​
errors
object[]
Minimum array length: 1

Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807 (https://tools.ietf.org/html/rfc7807).