Passer au contenu principal
Ce guide vous explique comment récupérer les Listes épinglées d’un utilisateur.
PrérequisAvant de commencer, vous aurez besoin :
  • D’un compte développeur avec une App approuvée
  • D’un jeton d’accès utilisateur (OAuth 1.0a ou OAuth 2.0 PKCE)

Récupérer les listes épinglées

1

Obtenir votre ID utilisateur

Vous avez besoin de l’ID de l’utilisateur authentifié. Vous pouvez le trouver à l’aide de l’endpoint de recherche d’utilisateur ou dans votre jeton d’accès (Access Token) : la partie numérique correspond à votre ID utilisateur.
2

Effectuer une requête pour les listes épinglées

cURL
curl "https://api.x.com/2/users/2244994945/pinned_lists?\
list.fields=follower_count,member_count,owner_id&\
expansions=owner_id&\
user.fields=created_at,username" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
3

Examiner la réponse

{
  "data": [
    {
      "id": "1454155907651158017",
      "name": "Tech News",
      "follower_count": 150,
      "member_count": 25,
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "name": "X Developers",
        "created_at": "2013-12-14T04:35:55.000Z"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}

Champs de Liste disponibles

ChampDescription
descriptionDescription de la Liste
owner_idID utilisateur du propriétaire
privateIndique si la Liste est privée
member_countNombre de membres
follower_countNombre d’abonnés
created_atDate de création de la Liste

Prochaines étapes

Gérer les listes épinglées

Épingler et désépingler des listes

Recherche de liste

Obtenir les détails d’une liste

Référence de l’API

Documentation complète du point de terminaison