Passer au contenu principal
Les endpoints de recherche d’utilisateurs vous permettent de récupérer les informations de profil d’un ou de plusieurs utilisateurs. Recherchez des utilisateurs par leur id, leur nom d’utilisateur, ou obtenez des informations détaillées sur l’utilisateur actuellement authentifié.

Vue d’ensemble

Par identifiant

Rechercher des utilisateurs par leur identifiant utilisateur unique

Par nom d’utilisateur

Rechercher des utilisateurs par leur @pseudo

Plusieurs utilisateurs

Récupérer jusqu’à 100 utilisateurs par requête

Utilisateur authentifié

Obtenir les informations de l’utilisateur actuel

Points de terminaison

MéthodePoint de terminaisonDescription
GET/2/users/:idRécupérer un utilisateur par identifiant
GET/2/usersRécupérer des utilisateurs par identifiants (jusqu’à 100)
GET/2/users/by/username/:usernameRécupérer un utilisateur par nom d’utilisateur
GET/2/users/byRécupérer des utilisateurs par noms d’utilisateur (jusqu’à 100)
GET/2/users/meRécupérer l’utilisateur authentifié

Exemple de requête

curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,public_metrics,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

Exemple de réponse

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "The voice of the X developer community",
    "verified": true,
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

Mise en route

Prérequis

Démarrage rapide pour la recherche d’utilisateurs

Rechercher des utilisateurs par ID ou nom d’utilisateur

Démarrage rapide pour l’utilisateur authentifié

Récupérer le profil de l’utilisateur authentifié

Guide d’intégration

Concepts clés et bonnes pratiques

Référence de l’API

Documentation complète de l’endpoint