Récupérer les statistiques d’une Publication

curl --request GET \
  --url https://api.x.com/2/tweets/analytics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.x.com/2/tweets/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/tweets/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/tweets/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

GET

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

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.x.com/2/tweets/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/tweets/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/tweets/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/tweets/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

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

Show child attributes

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

Show child attributes

Vue d’ensemble

Publications

Utilisateurs

Messages privés

Mentions J’aime

Listes

Espaces

Communautés

Notes de la communauté

Tendances

Actualités

Médias

Activité sur X

Utilisation

Connexions de flux

Conformité

Enterprise v2

Flux des J’aime

GNIP 2.0

Récupérer les statistiques d’une Publication

Autorisations

Paramètres de requête

Réponse