Vue d’ensemble

La dernière version de la X API v2 est une avancée majeure. Pour cette raison, nous avons divisé 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 ajoutés à la X API v2.
Prêt à migrer ?	Commencez votre migration avec un ensemble de guides et d’instructions.
Guide de migration du format de données	Apprenez à adapter vos analyseurs de données qui fonctionnaient auparavant avec les formats de données standard v1.1 et entreprise.
Correspondance des endpoints de la X API	Découvrez comment les endpoints standard v1.1 et entreprise correspondent aux nouveaux endpoints de la X API v2.

---

​

Qu’est-ce que X API v2 ?

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

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

​

Pourquoi migrer ?

La X API v2 est construite sur des bases modernes et plus durables, et inclut à la fois des endpoints de remplacement améliorés pour la version standard v1.1 et les produits Enterprise, ainsi que des fonctionnalités entièrement inédites. Nous encourageons fortement les clients des API héritées (v1.1 et Enterprise) à commencer à migrer vers v2, car nous avons l’intention de les mettre hors service à terme. Utilisez la X API pour écouter et analyser la conversation publique, interagir avec les personnes sur X et innover.

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

​

Points de terminaison v2

Vous pouvez consulter une liste complète des points de terminaison v2 et de leurs équivalents pré‑v2 dans le guide ci‑dessous :

Bien que la plupart des points de terminaison de X API v2 remplacent des points de terminaison existants, nous avons introduit plusieurs nouveaux points de terminaison. Voici quelques exemples de nouveaux points de terminaison que nous avons mis à disposition dans la v2 :

• Points de terminaison Spaces pour aider les utilisateurs à tirer davantage parti de X Spaces et permettre aux développeurs de contribuer à 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.
• De nouveaux points de terminaison Lists qui vous permettent d’épingler et de désépingler des Listes, ou de rechercher les Listes épinglées d’une personne.
• De nouveaux points de terminaison de conformité par lots qui vous permettent de garantir que les données d’utilisateurs et de Tweets que vous stockez sont conformes.

​

Nouvelles fonctionnalités

X API v2 comprend également de nouvelles fonctionnalités qui vous aideront à tirer davantage parti de X API. Une grande partie de ces nouveautés est issue de vos retours et inclut certaines fonctionnalités auparavant réservées aux clients entreprises.

Voici quelques-unes des améliorations apportées à l’API :

• Une conception cohérente entre les endpoints
• La possibilité de spécifier quels champs et objets sont renvoyés dans le corps 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 alimentées par les annotations de Tweets
• 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 universitaires
• Fonctionnalités de reprise et de redondance pour les endpoints de streaming
• Renvoyer facilement les décomptes de Tweets correspondant à une requête
• Prise en charge des Tweets modifiés
• Filtrage anti-spam à haut niveau de 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 champs 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 afin que vous puissiez effectuer des modifications sans interrompre les connexions
• Langage de requête 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 de manière plus transparente

​

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

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

Object	Description
Tweet	L’objet Tweet possède 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 User contient les métadonnées 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 même lang.
Lists	L’objet List contient des informations de base sur la liste demandée, y compris description, member_count et owner_id.
Media	Si un Tweet contient des médias (tels que des images), l’objet Media peut alors être récupéré à l’aide du paramètre media.fields et comporte 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 primaire sur un endpoint, mais il peut être retrouvé et étendu au sein de 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 et analyser des Tweets en fonction de leur localisation.

Découvrez plus en détail comment utiliser les champs et les expansions.

​

Flexibilité pour choisir les objets et les champs que vous recevez

Lorsque vous effectuez une requête GET sur un endpoint, vous recevez l’objet de données principal lié à cet endpoint, qui inclut un ensemble de champs par défaut. Par exemple, l’objet Tweet renvoie par défaut les champs id et text.

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

Voici la liste complète des expansions que vous pouvez demander avec les différents endpoints de 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

Pour en savoir plus, consultez comment utiliser les champs et les expansions.

​

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

Davantage de métriques sont désormais accessibles pour les objets Tweet, utilisateur, Spaces, Listes et média. Ces métriques peuvent être publiques ou privées, et certaines peuvent être ventilées par contexte organique ou sponsorisé pour les publicités de Tweets.

En savoir plus sur les métriques disponibles.

Objet	Métriques disponibles	Métriques publiques	Métriques privées	Métriques organiques	Métriques sponsorisées
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 des métadonnées sur les Tweets modifiés. La fonctionnalité Modifier le Tweet a été introduite pour des tests auprès des employés de X le 1er septembre 2022. À compter de cette date, les Tweets remplissant les conditions peuvent être modifiés pendant 30 minutes et jusqu’à 5 fois. En savoir plus sur Modifier les Tweets. En utilisant 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 contenant 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 savoir s’il reste du temps pour les 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 renverra la version la plus récente d’un Tweet, sauf si une version antérieure spécifique est demandée par Tweet ID).
• L’intégralité de l’historique de modification du Tweet.
• L’engagement attribué à chaque version du Tweet.

​

Suivez les conversations sous forme de fils

Un nouveau champ de Tweet permet d’identifier le fil de conversation auquel un Tweet appartient. Un ID de conversation est 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 tokens provenant de l’App développeur de ce Project

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

Une fois que vous avez un compte développeur, vous pouvez configurer tous les éléments ci-dessus dans la Console de développement.

​

Authentification

Avec la nouvelle API Twitter, vous utiliserez deux mécanismes d’authentification différents, OAuth 1.0a User Context et OAuth 2.0 Jeton Bearer, pour accéder à différents endpoints. Chacun remplit une fonction différente lors de l’envoi de requêtes aux endpoints :

OAuth 1.0a User Context est requis lorsque vous envoyez une requête pour le compte d’un utilisateur Twitter
OAuth 2.0 Jeton Bearer est requis pour envoyer des requêtes pour le compte de votre App de 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 lancer votre travail :

• Nous mettons à disposition une collection Postman Twitter qui vous permet d’utiliser le client Postman pour envoyer des requêtes et vous connecter à chacun des endpoints. C’est une méthode simple pour tester l’authentification et expérimenter avec les endpoints.
• Nous mettons également à disposition une liste de bibliothèques, prises en charge par Twitter ou tierces, en Ruby, Python, Node, Java et bien d’autres. Pour plus de contexte, consultez notre page sur les outils et bibliothèques.

​

Migration vers les endpoints mis à jour

À mesure que vous commencez à explorer les nouveaux endpoints Twitter v2, nous avons créé une série de guides de migration détaillés pour vous aider à comparer les fonctionnalités de chaque endpoint mis à jour avec celles des anciennes versions :

• Tweets
  • Consultation de Tweets
  • Gérer les Tweets
  • Chronologies
  • Recherche de Tweets
  • Nombre de Tweets
  • Flux filtré
  • Flux échantillonné
  • Retweets
  • Mentions J’aime
  • Masquer les réponses
• Utilisateurs
  • Consultation d’utilisateurs
  • Abonnements
  • Blocages
  • Mises en sourdine
• Listes
  • Consultation de listes
  • Gérer les listes
  • Consultation des Tweets d’une liste
  • Membres d’une liste

​

Migration vers le nouveau format de données

Lorsque vous passez de v1.1 ou d’Enterprise à v2, il est important de comprendre que le format dans lequel les données sont livrées a considérablement changé. Nous avons ajouté de nouveaux champs, modifié l’ordre des champs et, dans certains cas, supprimé certains éléments.

Pour en savoir plus sur ces changements, nous préparons une série de guides qui vous aideront à faire correspondre les champs du format de données pré‑v2 aux nouveaux champs, et à savoir comment demander ces nouveaux champs.

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

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

​

Et la suite ?

Ceux d’entre vous qui utilisent la plateforme depuis un certain temps remarqueront que de nombreux nouveaux endpoints sont alignés sur les endpoints standard v1.1 et enterprise existants. En effet, nous avons bien l’intention qu’ils remplacent à terme ces trois versions.

Nous avons préparé un tableau pour vous aider à comprendre comment les endpoints X API correspondent aux versions précédentes.

Si vous souhaitez voir ce qui est prévu pour la suite, veuillez consulter notre feuille de route produit.

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

​

Que devrions-nous développer ensuite ?

À mesure que nous étendons les capacités de la X API v2, nous souhaitons continuer à recueillir vos retours. Nous accueillons volontiers vos retours et vous encourageons à nous en faire part.

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