Passer au contenu principal

​
Introduction

Alors que le recent search endpoint vous permet uniquement de récupérer des Publications publiées au cours des 7 derniers jours, les endpoints de fil de Publications utilisateur et de fil de mentions utilisateur vous permettent de récupérer, pour un utilisateur autorisé (à l’aide de son id), des Publications et des mentions plus anciennes que les 7 derniers jours. Les développeurs peuvent utiliser ces endpoints pour étudier les sujets, les entités et le sentiment des Publications du fil ou des mentions d’un utilisateur. Dans ce tutoriel, nous allons vous montrer comment explorer les Publications et les mentions d’un utilisateur à l’aide des endpoints de fil de Tweets utilisateur et de fil de mentions utilisateur.  

​
Conditions préalables

​
Compte développeur approuvé

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

​
Créer un projet et connecter une App

Dans la Console de développement, cliquez sur « Create a new App ».
Donnez-lui un nom, sélectionnez le cas d’utilisation approprié et fournissez une description du projet. Ensuite, vous pouvez soit créer une nouvelle App, soit connecter une App existante (une App est un conteneur pour vos clés d’API dont vous avez besoin pour effectuer une requête HTTP vers 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 aurez cliqué sur « Complete », vous obtiendrez vos clés d’API et le Jeton Bearer que vous pourrez ensuite utiliser pour vous connecter aux nouveaux endpoints dans 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 d’API à l’étape suivante. Remarque : les clés dans la capture d’écran ci-dessus sont masquées, mais dans votre propre Console de développement, vous pourrez voir les valeurs réelles pour l’API key, l’API secret key et le Jeton Bearer.  

​
Comment obtenir l’ID utilisateur d’un utilisateur à utiliser avec les endpoints de timeline de Tweets utilisateur et de mentions utilisateur

Les endpoints de timeline de Tweets utilisateur et de mentions utilisateur vous permettent d’obtenir des Publications à l’aide de l’ID utilisateur. Pour obtenir l’ID utilisateur à partir d’un nom d’utilisateur, vous pouvez utiliser le nouveau user lookup endpoint v2. Remplacez USER_NAME par le nom d’utilisateur de votre choix et XXXX par votre propre Jeton Bearer que vous avez obtenu ci-dessus. 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Vous verrez l’identifiant de l’utilisateur dans la réponse, comme ci-dessous : 
{
   "data": {
       "id": "2244994945",
       "name": "Developers",
       "username": "XDevelopers"
   }
}

​
Connexion aux points de terminaison des timelines de Tweets de l’utilisateur et des mentions de l’utilisateur

Pour obtenir la timeline des Tweets d’un utilisateur, exécutez la commande curl suivante dans votre terminal (assurez-vous de remplacer USER_ID par l’id 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 verrez que la réponse JSON à ces requêtes contient par défaut le champ id et le texte des Publications (voir l’exemple ci-dessous). 
{
   "id": "1334200897081987072",
   "text": "👀 If you are new to the X API v2, check out this step-by-step guide to making your first request https://t.co/4rZqThpSbp"
}
Si vous souhaitez que des champs supplémentaires soient inclus dans la réponse (tels que des informations sur l’utilisateur, des champs de Tweet supplémentaires comme les annotations de contexte, etc.), vous devrez spécifier explicitement ces champs dans votre requête. Découvrez comment procéder dans le guide sur l’utilisation des champs et des expansions. Vous pouvez également récupérer ces Publications avec le langage de programmation de votre choix. Consultez nos exemples de code en Python, Node (JavaScript), Java et Ruby pour les endpoints de timeline des Tweets d’un utilisateur et de timeline des mentions d’un utilisateur dans notre dépôt GitHub.

​
Explorer les Publications de l’utilisateur

Une fois que vous savez comment obtenir des Publications à l’aide des endpoints de la chronologie des Tweets de l’utilisateur et de la chronologie de ses mentions, vous pouvez commencer à explorer ses Publications. Par exemple, si vous voulez 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 Tweets : 
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 existent dans les mentions. Voici un exemple : 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marques et sociétés"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Si vous souhaitez voir quelles entités populaires apparaissent dans vos mentions, vous pouvez compter ces entités populaires en analysant chaque Tweet dans les mentions. Si vous souhaitez explorer l’URL de l’image d’aperçu pour toutes les Publications de votre fil qui contiennent des médias, vous pouvez procéder comme suit : Dans la requête API, spécifiez que vous voulez preview_image_url dans les champs tweet.media et les expansions attachments.media_keys 
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 le champ 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 avez compris comment parcourir les Publications d’un utilisateur, vous pouvez également utiliser d’autres API et services pour exploiter davantage ces Publications. Vous trouverez ci-dessous quelques ressources à garder sous la main lorsque vous utilisez les endpoints de la chronologie des Tweets d’un utilisateur et de la chronologie de ses mentions.

​
Ressources