Aperçu

La dernière version de la X API v2 est une avancée majeure. À ce titre, nous avons scindé cette section de migration en plusieurs parties :

Nouveautés de la X API v2	Découvrez les nouveaux endpoints et les nouvelles fonctionnalités que nous avons publiés pour la X API v2.
Prêt à migrer ?	Lancez votre migration à l’aide d’un ensemble de guides et d’instructions.
Guide de migration du format de données	Découvrez comment adapter vos analyseurs de données qui fonctionnaient auparavant avec Standard v1.1 et les formats de données Enterprise.
Carte des endpoints de la X API	Découvrez comment les endpoints Standard v1.1 et Enterprise correspondent aux nouveaux endpoints de la X API v2.

---

​

Qu’est-ce que la X API v2 ?

La X API v2 est désormais l’API principale de X, et c’est là que se concentrent les investissements produit et l’innovation. Nous avons collaboré avec des développeurs pour créer la prochaine génération de la X API afin de mieux servir notre communauté de développeurs, diverse. Sur la base des retours des développeurs, nous avons repensé l’API pour répondre à un éventail plus large de besoins, introduit de nouvelles fonctionnalités et des endpoints, et amélioré l’expérience développeur.

La X API v2 est désormais l’API principale de X, et c’est là que se concentrent les investissements produit et l’innovation. Au cours des dernières années, nous avons collaboré avec des développeurs et repensé l’API pour répondre à un éventail plus large de besoins, introduire de nouvelles fonctionnalités et des endpoints, et améliorer l’expérience développeur. Nous nous engageons à continuer de bâtir une plateforme ouverte pour les développeurs et avons hâte de voir ce que vous créerez avec la X API v2.

​

Pourquoi migrer ?

L’API X v2 repose sur une base moderne et plus durable et comprend à la fois des endpoints de remplacement améliorés pour Standard v1.1 et les produits Enterprise, ainsi que des fonctionnalités entièrement nouvelles. Nous encourageons vivement les clients des API héritées (v1.1 et Enterprise) à commencer à migrer vers v2, car nous avons l’intention de les retirer à terme. Utilisez l’API X pour écouter et analyser la conversation publique, interagir avec les personnes sur X et innover.

Dans cette section, nous aborderons les endpoints et les fonctionnalités.

​

Endpoints v2

Vous trouverez la liste complète des endpoints v2 et leurs équivalents antérieurs dans le guide suivant :

X API Endpoint Map

Bien que la plupart des endpoints de X API v2 remplacent des endpoints précédents, nous avons introduit plusieurs nouveaux endpoints. Voici quelques exemples de nouveaux endpoints publiés en v2 :

• Endpoints Spaces pour aider les utilisateurs à tirer davantage parti de X Spaces et permettre aux développeurs de façonner l’avenir des conversations audio.
• Masquer les réponses, qui vous permet de créer des outils aidant à limiter à grande échelle l’impact de réponses abusives, distrayantes ou trompeuses.
• Nouveaux endpoints Lists qui vous permettent d’épingler et de désépingler des Lists, ou de consulter les Lists épinglées d’un utilisateur.
• Nouveaux endpoints de conformité par lot qui vous permettent de garantir la conformité des données d’utilisateurs et de Tweets que vous avez stockées.

​

Nouvelles fonctionnalités

X API v2 inclut également de nouvelles fonctionnalités qui vous aideront à tirer davantage parti de X API. Bon nombre des nouveautés ont été guidées par vos retours et incluent certaines fonctionnalités auparavant réservées aux clients Enterprise.

Parmi les améliorations apportées à l’API :

• Un design cohérent sur l’ensemble des endpoints
• La possibilité de spécifier quels fields et objets sont renvoyés dans le payload de la réponse
• De nouveaux objets de données plus détaillés
• Recevoir et filtrer des données avec de nouvelles informations contextuelles rendues possibles par les annotations de Tweet
• Accès à de nouvelles métriques
• Identifier et filtrer facilement les conversations appartenant à un fil de réponses
• Fonctionnalités avancées et accès accru aux données pour les chercheurs académiques
• Fonctionnalités de reprise et de redondance pour les endpoints de streaming
• Renvoyer facilement des décomptes de Tweets correspondant à une query
• Prise en charge de l’édition de Tweets
• Filtrage anti-spam à haute confiance
• Les URL raccourcies sont entièrement développées pour un filtrage et une analyse plus efficaces
• Objets de réponse JSON simplifiés grâce à la suppression des fields obsolètes et à la modernisation des libellés
• Restitution de 100 % des Tweets publics et disponibles correspondant aux requêtes de recherche
• « Règles » de streaming permettant d’apporter des modifications sans interrompre les connexions
• Langage de query plus expressif pour la recherche de Tweets, les décomptes de Tweets et le flux filtré
• Spécification OpenAPI pour créer de nouvelles bibliothèques et suivre les changements plus en transparence

​

Découvrir de nouveaux objets de réponse et des objets mis à jour

Les six objets de données suivants sont disponibles avec les endpoints v2 :

Objet	Description
Tweet	L’objet Tweet comporte une longue liste de champs au niveau racine, tels que id, text et created_at. Les objets Tweet sont également l’objet parent de plusieurs objets enfants, notamment user, media, poll et place.
User	L’objet utilisateur contient les metadata du compte X décrivant l’utilisateur référencé.
Spaces	L’objet Space se compose de champs tels que state, host_id, is_ticketed et lang.
Lists	L’objet List contient des informations de base sur la liste demandée, notamment description, member_count et owner_id.
Media	Si un Tweet contient des médias (tels que des images), l’objet media peut être demandé à l’aide du paramètre media.fields et inclut des champs tels que media_key, type, url, preview_image_url, et plus encore.
Poll	Un sondage inclus dans un Tweet n’est pas un objet principal sur un endpoint, mais peut être trouvé et développé dans l’objet Tweet.
Place	L’objet place se compose de champs tels que place_id, l’objet geo, country_code, et plus encore. Ces informations peuvent être utilisées pour identifier des Tweets et étudier des Tweets par localisation.

En savoir plus sur l’utilisation des fields et expansions.

​

Souplesse pour choisir les objets et fields que vous recevez

Lorsque vous envoyez une requête à un endpoint GET, vous recevez l’objet principal lié à cet endpoint, qui inclut un ensemble de fields par défaut. Par exemple, l’objet Tweet fournit par défaut les fields id et text.

Si vous souhaitez récupérer des fields supplémentaires avec votre requête, vous devez utiliser les paramètres fields et expansions. Le paramètre expansions permet de récupérer des objets de données associés, tels que le Tweet épinglé d’un utilisateur ou un objet média, tandis que les opérateurs de fields permettent de demander des fields spécifiques au sein des objets renvoyés, au-delà des valeurs par défaut.

Voici la liste complète des expansions que vous pouvez demander avec les différents endpoints de la X API v2 :

Objet / Ressource	Expansions disponibles
Tweets	author_id, edit_history_tweet_ids, entities.mentions.username, in_reply_to_user_id, referenced_tweets.id, referenced_tweets.id.author_id, attachments.poll_ids, attachments.media_keys, geo.place_id
Users	pinned_tweet_id
Spaces	invited_user_ids, speaker_ids, creator_id, host_ids, topic_ids

En savoir plus sur l’utilisation des fields et des expansions.

​

Nouvelles métriques disponibles dans les objets Tweets, utilisateurs, Spaces et médias

Davantage de métriques sont désormais accessibles dans les objets Tweet, utilisateur, Spaces, List et médias. Ces métriques peuvent être publiques ou privées, et certaines peuvent être ventilées en contextes organique ou sponsorisé pour les publicités de Tweet.

En savoir plus sur les métriques disponibles.

Object	Available Metrics	Public Metrics	Private Metrics	Organic Metrics	Promoted Metrics
tweets	retweet_count	✔️		✔️	✔️
	quote_count	✔️
	like_count	✔️		✔️	✔️
	reply_count	✔️		✔️	✔️
	impression_count		✔️	✔️	✔️
	url_profile_clicks		✔️	✔️	✔️
	url_link_clicks		✔️	✔️	✔️
user	follower_count	✔️
user	following_count	✔️
media	view_count		✔️
media	playback_0_count		✔️
space	participant_count	✔️

​

Modifier des Tweets

Les endpoints de la X API v2 fournissent les métadonnées des Tweets modifiés. La fonctionnalité Edit Tweet a été introduite pour la première fois en test auprès des employés de X le 1er septembre 2022. À partir de cette date, les Tweets éligibles sont modifiables pendant 30 minutes, et ce jusqu’à 5 fois. En savoir plus sur Edit Tweets. Avec la X API v2, un développeur peut déterminer :

• Si un Tweet était éligible à la modification au moment de sa création. Certains Tweets, comme ceux comportant des sondages ou les Tweets programmés, ne peuvent pas être modifiés.
• Les Tweets sont modifiables pendant 30 minutes et peuvent être modifiés jusqu’à 5 fois. Pour les Tweets modifiables, vous pouvez voir s’il reste du temps pour modifier et combien de modifications supplémentaires sont possibles.
• Si vous consultez une version modifiée d’un Tweet (dans la plupart des cas, l’API renvoie la version la plus récente d’un Tweet, sauf si une version antérieure spécifique est demandée par id de Tweet).
• L’intégralité de l’historique des modifications du Tweet.
• L’engagement attribué à chaque version du Tweet.

​

Suivre les conversations en fil

Un nouveau champ Tweet permet d’identifier à quel fil de conversation un Tweet appartient. Un identifiant de conversation correspond à l’id du Tweet qui a démarré la conversation. En savoir plus sur le suivi des conversations.

​

Prêt à migrer

Pour utiliser les endpoints v2, vous aurez besoin des éléments suivants :

• Un compte développeur
• Une App développeur créée au sein d’un Project
• Des clés et des jetons provenant de l’App développeur de ce Project

Veuillez noter l’importance d’utiliser des clés et des jetons provenant d’une App au sein d’un Project. Si vous utilisez des clés et des jetons d’une App en dehors d’un Project, vous ne pourrez pas effectuer de requêtes vers les endpoints v2.

Une fois que vous disposez d’un compte développeur, vous pouvez configurer tous les éléments ci-dessus dans le developer portal.

​

Authentification

Avec la nouvelle API de X, vous utiliserez deux modes d’authentification distincts, Contexte utilisateur OAuth 1.0a et OAuth 2.0 Bearer Token, pour accéder à différents endpoints. Chacun a une finalité différente lors de l’envoi de requêtes vers les endpoints :

Le Contexte utilisateur OAuth 1.0a est requis pour envoyer une requête au nom d’un utilisateur de X OAuth 2.0 Bearer Token est requis pour effectuer des requêtes au nom de votre App développeur

​

Outils et code

Pour vous aider à démarrer et à vous familiariser avec les nouveaux endpoints et fonctionnalités, nous proposons plusieurs options pour accélérer votre travail :

• Nous mettons à disposition une collection Postman X qui vous permet d’utiliser le client Postman pour envoyer des requêtes et vous connecter aux endpoints individuels. C’est un moyen simple de tester l’authentification et d’expérimenter avec les endpoints.
• Nous proposons également une liste de bibliothèques prises en charge par X ainsi que de bibliothèques tierces en Ruby, Python, Node, Java, et bien plus encore. Pour en savoir plus, consultez notre page sur les outils et bibliothèques.

​

Migration vers des endpoints mis à jour

À mesure que vous commencez à explorer les nouveaux endpoints v2 de Twitter, nous avons élaboré une série de guides de migration détaillés pour vous aider à comparer les capacités de chaque endpoint mis à jour par rapport aux versions antérieures :

• Tweets
  • Recherche de Tweets
  • Gérer les Tweets
  • Fils
  • Rechercher des Tweets
  • Décompte des Tweets
  • Flux filtré
  • Flux échantillonné
  • Retweets
  • Likes
  • Masquer les réponses
• Utilisateurs
  • Recherche d’utilisateurs
  • Abonnements
  • Blocages
  • Mises en sourdine
• Lists
  • Recherche de List
  • Gérer les Lists
  • Recherche de Tweets de List
  • Membres de List

​

Migration vers le nouveau format de données

Lorsque vous passez de v1.1 ou Enterprise à v2, il est important de comprendre que le format de livraison des données a profondément changé. Nous avons ajouté de nouveaux fields, modifié l’ordre des fields et, dans certains cas, supprimé certains éléments.

Pour en savoir plus sur ces changements, nous élaborons une série de guides qui vous aideront à faire correspondre les fields du format de données antérieur à v2 aux nouveaux fields, et qui décriront comment demander ces nouveaux fields.

Vous pouvez en apprendre davantage en consultant la section migration des formats de données de ce hub de migration, ou en parcourant nos guides spécifiques sur les formats de données :

• Format natif vers X API v2 (Standard v1.1)
• Native Enriched vers X API v2 (Enterprise)
• Activity Streams vers X API v2 (Enterprise)

​

Et ensuite ?

Celles et ceux d’entre vous qui utilisent la plateforme depuis un certain temps remarqueront que nombre des nouveaux endpoints sont alignés sur les endpoints Standard v1.1 et Enterprise existants. En effet, nous avons l’intention qu’ils remplacent à terme les trois versions.

Nous avons préparé un tableau pour vous aider à comprendre comment la correspondance des endpoints de la X API s’applique aux versions précédentes.

Si vous souhaitez découvrir ce qui arrive ensuite, veuillez consulter notre feuille de route produit.

Nous proposons également un changelog que vous pouvez consulter pour voir ce que nous avons déjà publié.

​

Que devrions-nous créer ensuite ?

À mesure que nous développons de nouvelles fonctionnalités de la X API v2, nous souhaitons continuer à recueillir vos retours. Nous les accueillons et les encourageons via ce canal : feedback.

Parcourez les idées déjà soumises, soutenez celles qui correspondent à vos besoins et partagez également vos commentaires !