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. 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. 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.
- 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écouvrez plus en détail comment utiliser les champs et les expansions.
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 :
Pour en savoir plus, consultez comment utiliser les champs et les expansions.
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.
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.
- 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
OAuth 2.0 Jeton Bearer est requis pour envoyer des requêtes pour le compte de votre App de développeur 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.
- Tweets
- Utilisateurs
- Listes
- Format natif vers X API v2 (v1.1 standard)
- Native Enriched vers X API v2 (Enterprise)
- Activity Streams vers X API v2 (Enterprise)