> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Consulta de usuário
> Os endpoints de consulta de usuários permitem recuperar informações de perfil de um ou mais usuários. Referência para o nível standard da X API v2 sobre lookup.
export const Button = ({href, children}) => {
return ;
};
Os endpoints de consulta de usuários permitem recuperar informações de perfil de um ou mais usuários. Consulte usuários pelo ID, pelo username, ou obtenha detalhes do usuário atualmente autenticado.
## Visão geral
Consulte usuários pelo user ID único
Consulte usuários pelo @handle
Recupere até 100 usuários por requisição
Obtenha os detalhes do usuário atual
***
## Endpoints
| Método | Endpoint | Descrição |
| :----- | :-------------------------------------------------------------------- | :------------------------------------- |
| GET | [`/2/users/:id`](/x-api/users/get-user-by-id) | Obter usuário por ID |
| GET | [`/2/users`](/x-api/users/get-users-by-ids) | Obter usuários por IDs (até 100) |
| GET | [`/2/users/by/username/:username`](/x-api/users/get-user-by-username) | Obter usuário por username |
| GET | [`/2/users/by`](/x-api/users/get-users-by-usernames) | Obter usuários por usernames (até 100) |
| GET | [`/2/users/me`](/x-api/users/get-my-user) | Obter usuário autenticado |
***
## Exemplo de requisição
```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"
```
## Exemplo de resposta
```json title="Exemplo de resposta" lines wrap icon="https://mintcdn.com/x-preview/Vn2KEkZaPF9LiPi3/icons/xds/icon-brackets.svg?fit=max&auto=format&n=Vn2KEkZaPF9LiPi3&q=85&s=ed2428e77bab43e57800e1a590e982fa" 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
}
}
}
```
***
## Introdução
**Pré-requisitos**
* Uma [conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info) aprovada
* Um [Project e App](/resources/fundamentals/developer-apps) no Developer Console
* As [chaves e tokens](/resources/fundamentals/authentication) do seu App
Consulte usuários por ID ou username
Obtenha o perfil do usuário atual
Conceitos-chave e melhores práticas
Documentação completa do endpoint