Passer au contenu principal

​
Introduction

Alors que l’endpoint de recherche récente ne permet d’obtenir que des Posts publiés au cours des 7 derniers jours, les endpoints de la timeline des Posts d’un utilisateur et de la timeline des mentions d’un utilisateur permettent de récupérer des Posts et des mentions plus anciens que 7 jours, pour un utilisateur autorisé (à l’aide de l’id utilisateur). Les développeurs peuvent utiliser ces endpoints pour étudier les sujets, les entités et le sentiment des Posts à partir de la timeline ou des mentions d’un utilisateur. Dans ce tutoriel, nous vous montrerons comment explorer les Posts et les mentions d’un utilisateur à l’aide des endpoints de la timeline des Tweets d’un utilisateur et de la timeline des mentions d’un utilisateur.  

​
Prérequis

  • Pour utiliser les endpoints de chronologie des Tweets d’utilisateur et de chronologie des mentions d’utilisateur, vous devez disposer d’un compte développeur valide.
  • Vous aurez également besoin d’un Project créé.
  • Vous devez vous être inscrit à un compte développeur et avoir activé la nouvelle expérience du developer portal.
  • L’accès est disponible avec des clés et jetons actifs pour une App développeur rattachée à un Project créé dans le developer portal.
  • Un Jeton Bearer issu de votre App dans le X developer portal.
  • Si vous n’avez pas de compte développeur approuvé, vous pouvez en faire la demande.

​
Compte développeur approuvé

Si vous n’en avez pas encore, vous pouvez en faire la demande.

​
Créer un Project et connecter une App

Dans le developer portal, cliquez sur create a new Project.
Donnez-lui un nom, sélectionnez le cas d’usage approprié et fournissez une description du Project. Ensuite, vous pouvez soit créer une nouvelle App, soit connecter une App existante (une App est un conteneur pour vos API Keys dont vous avez besoin pour effectuer une requête HTTP vers la X API).
Cliquez sur « create a new App instead » et donnez un nom à votre App afin de créer une nouvelle App.
Une fois que vous cliquez sur complete, vous obtiendrez vos API Keys et le Jeton Bearer que vous pourrez ensuite utiliser pour vous connecter aux nouveaux endpoints de la X API v2.
Cliquez sur le (+) à côté de API Key, API Secret Key et Bearer Token et copiez ces valeurs dans un endroit sûr sur votre machine locale. Vous en aurez besoin pour effectuer les appels à l’API à l’étape suivante. Note : Les clés dans la capture d’écran ci-dessus sont masquées, mais dans votre propre developer portal, vous pourrez voir les valeurs réelles pour l’API Key, l’API Secret Key et le Bearer Token.  

​
Comment obtenir l’id d’un utilisateur à utiliser dans les endpoints de chronologie des Tweets d’utilisateur et de mentions d’utilisateur

Les endpoints de chronologie des Tweets d’utilisateur et de mentions d’utilisateur vous permettent d’obtenir des Posts à partir de l’id d’un utilisateur. Pour obtenir l’id à partir d’un nom d’utilisateur, vous pouvez utiliser le nouvel endpoint de recherche d’utilisateurs v2. Remplacez USER_NAME par le nom d’utilisateur de votre choix et XXXX par votre propre Jeton Bearer obtenu ci‑dessus 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Vous verrez l’id de l’utilisateur dans la réponse, comme illustré ci‑dessous : 
{
   "data": {
       "id": "2244994945",
       "name": "Développeurs",
       "username": "XDevelopers"
   }
}

​
Connexion aux endpoints de la chronologie des Tweets d’utilisateur et des mentions d’utilisateur

Pour obtenir la chronologie des Tweets d’un utilisateur, exécutez la commande curl suivante dans votre terminal (assurez-vous de remplacer USER_ID par l’id de l’utilisateur de votre choix et XXXX par votre propre Jeton Bearer obtenu ci-dessus) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Vous constaterez que la réponse JSON pour ces requêtes contient par défaut l’id et le texte des Posts (voir l’exemple ci-dessous). 
{
   "id": "1334200897081987072",
   "text": "👀 Si vous découvrez l'X API v2, consultez ce guide étape par étape pour effectuer votre première requête https://t.co/4rZqThpSbp"
}
Si vous souhaitez que des fields supplémentaires soient renvoyés dans la réponse (par exemple des informations sur l’utilisateur, des Tweet fields supplémentaires comme les context annotations, etc.), vous devrez spécifier explicitement ces fields dans votre requête. Découvrez comment procéder dans le guide sur l’utilisation des fields et des expansions. Vous pouvez également récupérer ces Posts avec le langage de programmation de votre choix. Consultez nos Exemples de code en Python, Node (JavaScript), Java et Ruby pour les endpoints de la timeline des Tweets d’un utilisateur et de la timeline des mentions d’un utilisateur sur notre GitHub repository.

​
Explorer les Posts de l’utilisateur

Une fois que vous savez comment récupérer des Posts à l’aide des endpoints de chronologie des Tweets d’un utilisateur et de chronologie des mentions d’un utilisateur, vous pouvez commencer à explorer ses Posts. Par exemple, si vous souhaitez identifier les entités nommées courantes présentes dans les mentions d’un utilisateur, vous pouvez procéder comme suit : Dans la requête API, indiquez que vous souhaitez que l’objet context_annotations soit renvoyé dans les réponses de Tweet : 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
Dans la réponse, vous verrez si des entités nommées apparaissent dans les mentions. Voici un exemple : 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marques et entreprises"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Si vous souhaitez voir quelles entités populaires apparaissent dans vos mentions, vous pouvez comptabiliser les entités populaires en analysant chaque Tweet dans les mentions. Si vous souhaitez explorer l’URL de l’image d’aperçu pour tous les Posts de votre fil qui contiennent des médias, vous pouvez procéder comme suit : Dans la requête API, indiquez que vous voulez preview_image_url dans les tweet.media fields, ainsi que les attachments.media_keys expansions 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
Dans la réponse, vous verrez preview_image_url dans l’objet includes, comme indiqué ci-dessous : 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
Une fois que vous comprenez comment parcourir les Posts d’un utilisateur, vous pouvez également utiliser d’autres API et services pour aller plus loin avec ces Posts. Vous trouverez ci-dessous quelques ressources utiles lors de l’utilisation des endpoints de la timeline des Tweets d’un utilisateur et de la timeline de ses mentions.

​
Ressources

⌘I