Fil des mentions d’utilisateur

Obtenir les Publications qui mentionnent un utilisateur spécifique

Ce guide vous explique comment récupérer les Publications qui mentionnent un utilisateur spécifique.

Prérequis

Avant de commencer, vous aurez besoin de :

• D’un compte développeur avec une App approuvée
• Du Jeton Bearer de votre App (pour les données publiques) ou d’un jeton d’accès utilisateur (pour les métriques privées)

---

​

Obtenir les mentions d’un utilisateur

1. Obtenir l’ID de l’utilisateur

   Trouvez l’ID de l’utilisateur à l’aide du point de terminaison de recherche d’utilisateurs. Par exemple, @XDevelopers a pour ID d’utilisateur 2244994945.

2. Effectuer une requête pour la timeline des mentions

   cURL

   shellscript

   curl "https://api.x.com/2/users/2244994945/mentions?\
   tweet.fields=created_at,public_metrics,author_id&\
   expansions=author_id&\
   user.fields=username,verified&\
   max_results=10" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Examiner la réponse

   {
     "data": [
       {
         "id": "1301573587187331074",
         "text": "Salut @XDevelopers, j’adore la nouvelle API !",
         "author_id": "1234567890",
         "created_at": "2024-01-15T10:30:00.000Z",
         "public_metrics": {
           "retweet_count": 5,
           "reply_count": 2,
           "like_count": 42,
           "quote_count": 1
         }
       }
     ],
     "includes": {
       "users": [
         {
           "id": "1234567890",
           "username": "developer",
           "name": "Dev Person",
           "verified": false
         }
       ]
     },
     "meta": {
       "newest_id": "1301573587187331074",
       "oldest_id": "1301573587187331074",
       "result_count": 1,
       "next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28"
     }
   }
   

---

​

Filtrer les mentions

​

Exclure les réponses

Récupérez uniquement les Publications originales qui mentionnent l’utilisateur :

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/mentions?\
exclude=replies&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​

Obtenir les mentions dans un intervalle de temps donné

cURL

shellscript

curl "https://api.x.com/2/users/2244994945/mentions?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z" \
  -H "Authorization: Bearer $BEARER_TOKEN"

---

​

Paramètres communs

Paramètre	Description	Valeur par défaut
max_results	Nombre de résultats par page (1-100)	10
start_time	Horodatage de la Publication la plus ancienne (ISO 8601)	—
end_time	Horodatage de la Publication la plus récente (ISO 8601)	—
since_id	Renvoyer les Publications après cet identifiant	—
until_id	Renvoyer les Publications avant cet identifiant	—
exclude	Exclure retweets, replies ou les deux	—
pagination_token	Jeton pour la page suivante	—

---

​

Étapes suivantes

Fil d’accueil

Récupérer le fil d’accueil d’un utilisateur

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint

Guide de pagination

Parcourir de grands ensembles de résultats