> ## 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.
# User Lookup
> User lookup 엔드포인트를 사용하면 한 명 이상의 사용자에 대한 프로필 정보를 조회할 수 있습니다. Lookup을 다루는 X API v2 standard 티어 레퍼런스입니다.
export const Button = ({href, children}) => {
return ;
};
User lookup 엔드포인트를 사용하면 한 명 이상의 사용자에 대한 프로필 정보를 조회할 수 있습니다. ID나 username으로 사용자를 조회하거나, 현재 인증된 사용자의 세부 정보를 가져올 수 있습니다.
## 개요
고유한 사용자 ID로 사용자 조회
@handle로 사용자 조회
요청당 최대 100명의 사용자 조회
현재 사용자의 세부 정보 가져오기
***
## 엔드포인트
| Method | Endpoint | Description |
| :----- | :-------------------------------------------------------------------- | :---------------------------- |
| GET | [`/2/users/:id`](/x-api/users/get-user-by-id) | ID로 사용자 가져오기 |
| GET | [`/2/users`](/x-api/users/get-users-by-ids) | ID로 사용자 가져오기 (최대 100명) |
| GET | [`/2/users/by/username/:username`](/x-api/users/get-user-by-username) | username으로 사용자 가져오기 |
| GET | [`/2/users/by`](/x-api/users/get-users-by-usernames) | username으로 사용자 가져오기 (최대 100명) |
| GET | [`/2/users/me`](/x-api/users/get-my-user) | 인증된 사용자 가져오기 |
***
## 요청 예시
```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"
```
## 응답 예시
```json title="응답 예시" 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
}
}
}
```
***
## 시작하기
**사전 요구사항**
* 승인된 [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* Developer Console 내의 [Project와 App](/resources/fundamentals/developer-apps)
* App의 [key와 token](/resources/fundamentals/authentication)
ID나 username으로 사용자 조회
현재 사용자의 프로필 가져오기
핵심 개념 및 모범 사례
전체 엔드포인트 문서