> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Recherche d’utilisateurs

> Récupérer des profils utilisateur par ID, par nom d’utilisateur ou pour l’utilisateur authentifié

export const Button = ({href, children}) => {
  return <div className="not-prose group">
    <a href={href}>
      <button className="flex items-center space-x-2.5 py-1 px-4 bg-primary-dark dark:bg-white text-white dark:text-gray-950 rounded-full group-hover:opacity-[0.9] font-medium">
        <span>
          {children}
        </span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

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é.

<div id="overview">
  ## Vue d’ensemble
</div>

<CardGroup cols={2}>
  <Card title="Par identifiant" icon="fingerprint">
    Rechercher des utilisateurs par leur identifiant utilisateur unique
  </Card>

  <Card title="Par nom d’utilisateur" icon="at">
    Rechercher des utilisateurs par leur @pseudo
  </Card>

  <Card title="Plusieurs utilisateurs" icon="users">
    Récupérer jusqu’à 100 utilisateurs par requête
  </Card>

  <Card title="Utilisateur authentifié" icon="user-check">
    Obtenir les informations de l’utilisateur actuel
  </Card>
</CardGroup>

***

<div id="endpoints">
  ## Points de terminaison
</div>

| Méthode | Point de terminaison                                                     | Description                                                     |
| :------ | :----------------------------------------------------------------------- | :-------------------------------------------------------------- |
| GET     | [`/2/users/:id`](/fr/x-api/users/get-user-by-id)                         | Récupérer un utilisateur par identifiant                        |
| GET     | [`/2/users`](/fr/x-api/users/get-users-by-ids)                           | Récupérer des utilisateurs par identifiants (jusqu'à 100)       |
| GET     | [`/2/users/by/username/:username`](/fr/x-api/users/get-user-by-username) | Récupérer un utilisateur par nom d'utilisateur                  |
| GET     | [`/2/users/by`](/fr/x-api/users/get-users-by-usernames)                  | Récupérer des utilisateurs par noms d'utilisateur (jusqu'à 100) |
| GET     | [`/2/users/me`](/fr/x-api/users/get-my-user)                             | Récupérer l'utilisateur authentifié                             |

***

<div id="example-request">
  ## Exemple de requête
</div>

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

<div id="example-response">
  ## Exemple de réponse
</div>

```json theme={null}
{
  "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
    }
  }
}
```

***

<div id="getting-started">
  ## Mise en route
</div>

<Note>
  **Prérequis**

  * Un [compte développeur](https://developer.x.com/en/portal/petition/essential/basic-info) approuvé
  * Un [Projet et App](/fr/resources/fundamentals/developer-apps) dans la Console de développement
  * Les [clés et jetons](/fr/resources/fundamentals/authentication) de votre App
</Note>

<CardGroup cols={2}>
  <Card title="Démarrage rapide pour la recherche d’utilisateurs" icon="rocket" href="/fr/x-api/users/lookup/quickstart/user-lookup">
    Rechercher des utilisateurs par ID ou nom d’utilisateur
  </Card>

  <Card title="Démarrage rapide pour l’utilisateur authentifié" icon="user" href="/fr/x-api/users/lookup/quickstart/authenticated-lookup">
    Récupérer le profil de l’utilisateur authentifié
  </Card>

  <Card title="Guide d’intégration" icon="book" href="/fr/x-api/users/lookup/integrate">
    Concepts clés et bonnes pratiques
  </Card>

  <Card title="Référence de l’API" icon="code" href="/fr/x-api/users/get-user-by-id">
    Documentation complète de l’endpoint
  </Card>
</CardGroup>