사용자 조회

ID, 사용자 이름 또는 현재 인증된 사용자의 프로필을 조회합니다

User 조회 엔드포인트를 사용하면 하나 이상의 사용자 프로필 정보를 조회할 수 있습니다. 사용자를 id나 사용자 이름으로 조회하거나, 현재 인증된 사용자의 자세한 정보를 가져올 수 있습니다.

​

개요

ID로 조회

고유한 사용자 ID로 사용자를 조회합니다

사용자 이름으로 조회

사용자의 @handle로 사용자를 조회합니다

여러 사용자

요청당 최대 100명의 사용자를 조회합니다

인증된 사용자

현재 인증된 사용자의 세부 정보를 가져옵니다

---

​

엔드포인트

Method	Endpoint	Description
GET	/2/users/:id	ID로 사용자 조회
GET	/2/users	여러 ID로 사용자 조회 (최대 100개)
GET	/2/users/by/username/:username	사용자 이름으로 사용자 조회
GET	/2/users/by	여러 사용자 이름으로 사용자 조회 (최대 100개)
GET	/2/users/me	인증된 사용자 조회

---

​

예시 요청

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

​

예시 응답

{
  "data": {
    "id": "2244994945",
    "name": "X Developers",
    "username": "XDevelopers",
    "created_at": "2013-12-14T04:35:55.000Z",
    "description": "X 개발자 커뮤니티의 목소리",
    "verified": true,
    "public_metrics": {
      "followers_count": 583423,
      "following_count": 2048,
      "tweet_count": 14052,
      "listed_count": 1672
    }
  }
}

---

​

시작하기

사전 준비 사항

• 승인된 개발자 계정
• 개발자 콘솔의 Project 및 App
• App의 키와 토큰

사용자 조회 빠른 시작

ID 또는 사용자 이름으로 사용자 조회하기

인증된 사용자 빠른 시작

현재 사용자의 프로필 가져오기

통합 가이드

핵심 개념과 모범 사례

API 참조 문서

전체 엔드포인트 문서