> ## 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 퀵스타트
> 이 가이드는 ID나 username으로 사용자를 조회하는 방법을 안내합니다. 퀵스타트를 다루는 X API v2 standard 티어 레퍼런스입니다.
export const Button = ({href, children}) => {
return ;
};
이 가이드는 ID나 username으로 사용자를 조회하는 방법을 안내합니다.
**사전 요구사항**
시작하기 전에 다음이 필요합니다:
* 승인된 App이 포함된 [developer account](https://developer.x.com/en/portal/petition/essential/basic-info)
* App의 Bearer Token
***
## ID로 조회
### 단일 사용자
```bash cURL theme={null}
curl "https://api.x.com/2/users/2244994945?\
user.fields=created_at,description,verified,public_metrics" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# ID로 사용자 가져오기
response = client.users.get(
"2244994945",
user_fields=["created_at", "description", "verified", "public_metrics"]
)
print(f"Name: {response.data.name}")
print(f"Username: {response.data.username}")
print(f"Followers: {response.data.public_metrics.followers_count}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// ID로 사용자 가져오기
const response = await client.users.get("2244994945", {
userFields: ["created_at", "description", "verified", "public_metrics"],
});
console.log(`Name: ${response.data?.name}`);
console.log(`Username: ${response.data?.username}`);
console.log(`Followers: ${response.data?.public_metrics?.followers_count}`);
```
### 응답
```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
}
}
}
```
### 여러 사용자
한 번에 최대 100명의 사용자 조회:
```bash cURL theme={null}
curl "https://api.x.com/2/users?\
ids=2244994945,783214,6253282&\
user.fields=username,verified" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# ID로 여러 사용자 가져오기
response = client.users.get_users(
ids=["2244994945", "783214", "6253282"],
user_fields=["username", "verified"]
)
for user in response.data:
print(f"{user.username} - Verified: {user.verified}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// ID로 여러 사용자 가져오기
const response = await client.users.getUsers({
ids: ["2244994945", "783214", "6253282"],
userFields: ["username", "verified"],
});
response.data?.forEach((user) => {
console.log(`${user.username} - Verified: ${user.verified}`);
});
```
***
## username으로 조회
### 단일 사용자
```bash cURL theme={null}
curl "https://api.x.com/2/users/by/username/XDevelopers?\
user.fields=created_at,description,verified" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# username으로 사용자 가져오기
response = client.users.get_by_username(
"XDevelopers",
user_fields=["created_at", "description", "verified"]
)
print(f"ID: {response.data.id}")
print(f"Name: {response.data.name}")
```
```javascript JavaScript SDK theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// username으로 사용자 가져오기
const response = await client.users.getByUsername("XDevelopers", {
userFields: ["created_at", "description", "verified"],
});
console.log(`ID: ${response.data?.id}`);
console.log(`Name: ${response.data?.name}`);
```
### 여러 사용자
```bash cURL theme={null}
curl "https://api.x.com/2/users/by?\
usernames=XDevelopers,X,elonmusk&\
user.fields=created_at,verified" \
-H "Authorization: Bearer $BEARER_TOKEN"
```
```python title="Python SDK" lines wrap icon="python" theme={null}
from xdk import Client
client = Client(bearer_token="YOUR_BEARER_TOKEN")
# username으로 여러 사용자 가져오기
response = client.users.get_users_by_usernames(
usernames=["XDevelopers", "X", "elonmusk"],
user_fields=["created_at", "verified"]
)
for user in response.data:
print(f"{user.username} - {user.created_at}")
```
```javascript title="JavaScript SDK" lines wrap icon="square-js" theme={null}
import { Client } from "@xdevplatform/xdk";
const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });
// username으로 여러 사용자 가져오기
const response = await client.users.getUsersByUsernames({
usernames: ["XDevelopers", "X", "elonmusk"],
userFields: ["created_at", "verified"],
});
response.data?.forEach((user) => {
console.log(`${user.username} - ${user.created_at}`);
});
```
***
## 사용 가능한 필드
| Field | Description |
| :------------------ | :---------- |
| `created_at` | 계정 생성 날짜 |
| `description` | 사용자 소개 |
| `profile_image_url` | 아바타 URL |
| `verified` | 인증 상태 |
| `public_metrics` | 팔로워/팔로잉 수 |
| `location` | 사용자가 설정한 위치 |
| `url` | 사용자의 웹사이트 |
| `protected` | 비공개 계정 상태 |
| `pinned_tweet_id` | 고정된 Post ID |
***
## 오류 처리
### 사용자를 찾을 수 없음
```json theme={null}
{
"errors": [
{
"resource_type": "user",
"title": "Not Found Error",
"detail": "Could not find user with username: [nonexistent_user]."
}
]
}
```
### 비공개 사용자
비공개 사용자의 데이터는 반환되지만, 해당 사용자를 팔로우하지 않는 이상 그들의 Post에 접근할 수는 없습니다.
***
## 다음 단계
현재 사용자 가져오기
핵심 개념 및 모범 사례
전체 엔드포인트 문서