메인 콘텐츠로 건너뛰기
사용자 작업용 클라이언트 이 클라이언트는 X API의 사용자 엔드포인트와 상호작용하기 위한 메서드를 제공합니다. 사용자 관련 모든 작업에 대해 인증, 요청 서식화, 응답 파싱을 처리합니다.

생성자

constructor

new UsersClient(client): UsersClient 새 Users 클라이언트 인스턴스를 생성합니다

매개변수

이름유형설명
clientClient주요 X API 클라이언트 인스턴스

반환

UsersClient

정의됨

users/client.ts:720

메서드

getMentions

getMentions(id, options?): Promise<Get2UsersIdMentionsResponse> 멘션 가져오기 지정한 User의 id를 기준으로 해당 User를 언급한 Post 목록을 가져옵니다.

매개변수

이름타입설명
idstring조회할 사용자 ID입니다.
optionsGetMentionsOptions-

반환

Promise<Get2UsersIdMentionsResponse> API 응답으로 이행되는 Promise

정의 위치

users/client.ts:737

getRepostsOfMe

getRepostsOfMe(options?): Promise<Get2UsersRepostsOfMeResponse> 나에 대한 리포스트 가져오기 인증된 사용자의 콘텐츠를 리포스트한 Post 목록을 반환합니다.

매개변수

이름유형
optionsGetRepostsOfMeOptions

반환값

Promise<Get2UsersRepostsOfMeResponse> API 응답으로 해결되는 Promise

정의됨

users/client.ts:849

getBookmarks

getBookmarks(id, options?): Promise<Get2UsersIdBookmarksResponse> 북마크 가져오기 인증된 사용자가 북마크한 Post 목록을 가져옵니다.

매개변수

이름타입설명
idstring결과를 반환할 인증된 소스 사용자에 대한 ID입니다.
optionsGetBookmarksOptions-

반환

Promise<Get2UsersIdBookmarksResponse> API 응답으로 이행되는 Promise

정의됨

users/client.ts:938

createBookmark

createBookmark(id, body): Promise<BookmarkMutationResponse> 북마크 생성 인증된 사용자의 북마크에 Post를 추가합니다.

매개변수

이름유형설명
idstring북마크를 추가할 인증된 소스 사용자의 ID.
bodyBookmarkAddRequest요청 본문

반환값

Promise<BookmarkMutationResponse> API 응답으로 resolve되는 Promise

정의된 위치

users/client.ts:1032

getBlocking

getBlocking(id, options?): Promise<Get2UsersIdBlockingResponse> 차단 조회 지정된 사용자 ID가 차단한 사용자 목록을 조회합니다.

매개변수

이름유형설명
idstring결과를 반환할 인증된 소스 사용자의 id입니다.
optionsGetBlockingOptions-

반환

Promise<Get2UsersIdBlockingResponse> API 응답으로 이행되는 Promise

정의됨

users/client.ts:1075

getBookmarksByFolderId

getBookmarksByFolderId(id, folderId): Promise<BookmarkFolderPostsResponse> 폴더 ID로 북마크 가져오기 인증된 사용자의 특정 북마크 폴더에서 해당 ID로 포함된 Posts를 가져옵니다.

매개변수

이름유형설명
idstring결과를 반환할 인증된 소스 사용자(User)의 id입니다.
folderIdstring인증된 사용자(User)가 Post를 가져오려는 북마크 폴더의 id입니다.

반환

Promise<BookmarkFolderPostsResponse> API 응답으로 해결되는 Promise

정의 위치

users/client.ts:1153

getById

getById(id, options?): Promise<Get2UsersIdResponse> ID로 사용자 조회 ID를 통해 특정 사용자의 세부 정보를 조회합니다.

매개변수

이름유형설명
idstring조회할 사용자(User)의 id.
optionsGetByIdOptions-

반환

Promise<Get2UsersIdResponse> API 응답으로 이행되는 Promise

정의됨

users/client.ts:1196

unrepostPost

unrepostPost(id, sourceTweetId): Promise<UsersRetweetsDeleteResponse> Post 재게시 취소 인증된 사용자가 ID로 지정된 특정 Post의 재게시를 취소합니다.

매개변수

이름타입설명
idstringPost 재게시를 요청하는 인증된 소스 사용자의 ID입니다.
sourceTweetIdstring사용자가 리트윗 취소를 요청하는 Post의 ID입니다.

반환

Promise<UsersRetweetsDeleteResponse> API 응답으로 resolve되는 Promise

정의된 위치

users/client.ts:1262

getFollowers

getFollowers(id, options?): Promise<Get2UsersIdFollowersResponse> 팔로워 가져오기 지정한 사용자의 ID를 기준으로 해당 사용자를 팔로우하는 사용자 목록을 반환합니다.

매개변수

이름유형설명
idstring조회할 사용자의 id입니다.
optionsGetFollowersOptions-

반환

Promise<Get2UsersIdFollowersResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:1308

likePost

likePost(id, options?): Promise<UsersLikesCreateResponse> Post 좋아요 인증된 사용자가 지정된 ID의 특정 Post에 좋아요를 표시합니다.

매개변수

이름타입설명
idstringPost에 좋아요를 요청하는 인증된 소스 User의 ID입니다.
optionsLikePostOptions-

반환

Promise<UsersLikesCreateResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:1382

unlikePost

unlikePost(id, tweetId): Promise<UsersLikesDeleteResponse> Post 좋아요 취소 인증된 사용자가 ID로 지정된 특정 Post의 좋아요를 취소합니다.

매개변수

이름타입설명
idstring좋아요 취소를 요청하는 인증된 소스 사용자의 ID입니다.
tweetIdstring사용자가 좋아요 취소를 요청하는 Post의 ID입니다.

반환

Promise<UsersLikesDeleteResponse> API 응답으로 해결되는 Promise

정의 위치

users/client.ts:1434

unfollowList

unfollowList(id, listId): Promise<ListFollowedResponse> 리스트 팔로우 해제 인증된 사용자가 지정한 ID의 특정 리스트 팔로우를 해제합니다.

매개변수

이름유형설명
idstring목록 언팔로우를 수행하는 인증된 소스 사용자(User)의 id입니다.
listIdstring언팔로우할 목록(List)의 id입니다.

반환값

Promise<ListFollowedResponse> API 응답으로 resolve되는 Promise

정의됨

users/client.ts:1478

getFollowing

getFollowing(id, options?): Promise<Get2UsersIdFollowingResponse> 팔로잉 가져오기 특정 사용자의 ID를 통해 해당 사용자가 팔로우하는 사용자 목록을 조회합니다.

매개변수

이름유형설명
idstring조회할 사용자의 id입니다.
optionsGetFollowingOptions-

반환

Promise<Get2UsersIdFollowingResponse> API 응답으로 해소되는 Promise

정의됨

users/client.ts:1521

followUser

followUser(id, options?): Promise<UsersFollowingCreateResponse> 사용자 팔로우 인증된 사용자가 지정한 사용자 ID를 가진 사용자를 팔로우합니다.

매개변수

이름유형설명
idstring대상 사용자를 팔로우하도록 요청하는 인증된 소스 사용자의 id입니다.
optionsFollowUserOptions-

반환

Promise<UsersFollowingCreateResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:1595

getLikedPosts

getLikedPosts(id, options?): Promise<Get2UsersIdLikedTweetsResponse> 좋아요한 Post 가져오기 특정 사용자의 id를 사용해 해당 사용자가 좋아요한 Post 목록을 가져옵니다.

매개변수

이름유형설명
idstring조회할 사용자 id입니다.
optionsGetLikedPostsOptions-

반환

Promise<Get2UsersIdLikedTweetsResponse> API 응답으로 이행되는 Promise

정의된 위치

users/client.ts:1643

unfollowUser

unfollowUser(sourceUserId, targetUserId): Promise<UsersFollowingDeleteResponse> 사용자 언팔로우 인증된 사용자가 지정된 사용자의 ID를 통해 해당 사용자의 팔로우를 취소합니다.

매개변수

이름유형설명
sourceUserIdstring대상 사용자에 대한 언팔로우를 요청하는, 인증된 소스 사용자의 id입니다.
targetUserIdstring소스 사용자가 언팔로우를 요청하는 대상 사용자의 id입니다.

반환

Promise<UsersFollowingDeleteResponse> API 응답으로 resolve되는 Promise

정의됨

users/client.ts:1739

unpinList

unpinList(id, listId): Promise<ListUnpinResponse> 리스트 고정 해제 인증된 사용자가 ID로 지정된 특정 리스트의 고정을 해제합니다.

매개변수

이름유형설명
idstring결과를 반환할 인증된 소스 사용자의 id입니다.
listIdstring고정을 해제할 리스트의 id입니다.

반환값

Promise<ListUnpinResponse> API 응답으로 해결되는 Promise

정의된 위치

users/client.ts:1792

repostPost

repostPost(id, options?): Promise<UsersRetweetsCreateResponse> Post 리포스트 인증된 사용자가 ID로 지정된 특정 Post를 리포스트합니다.

매개변수

이름타입설명
idstringPost를 재게시하도록 요청하는 인증된 소스 사용자(User)의 id입니다.
optionsRepostPostOptions-

반환값

Promise<UsersRetweetsCreateResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:1832

getPinnedLists

getPinnedLists(id, options?): Promise<Get2UsersIdPinnedListsResponse> 고정된 리스트 가져오기 인증된 사용자가 고정한 리스트를 조회합니다.

매개변수

이름타입설명
idstring결과를 반환할 인증된 소스 사용자에 대한 ID입니다.
optionsGetPinnedListsOptions-

반환

Promise<Get2UsersIdPinnedListsResponse> API 응답으로 resolve되는 Promise

정의됨

users/client.ts:1880

pinList

pinList(id, body): Promise<ListPinnedResponse> 리스트 고정 인증된 사용자가 ID로 지정한 특정 리스트를 고정합니다.

매개변수

이름유형설명
idstring목록을 고정할 인증된 소스 사용자의 ID.
bodyListPinnedRequest요청 본문

반환

Promise<ListPinnedResponse> API 응답으로 이행되는 Promise

정의됨

users/client.ts:1944

getListMemberships

getListMemberships(id, options?): Promise<Get2UsersIdListMembershipsResponse> 리스트 멤버십 조회 특정 사용자의 ID를 기준으로, 해당 사용자가 구성원으로 속한 리스트들을 가져옵니다.

매개변수

이름타입설명
idstring조회할 사용자 id입니다.
optionsGetListMembershipsOptions-

반환

Promise<Get2UsersIdListMembershipsResponse> API 응답으로 resolve되는 Promise

정의

users/client.ts:1984

unmuteUser

unmuteUser(sourceUserId, targetUserId): Promise<MuteUserMutationResponse> 사용자 음소거 해제 인증된 사용자가 사용자 ID로 지정된 특정 사용자의 음소거를 해제합니다.

매개변수

이름유형설명
sourceUserIdstring대상 사용자의 음소거 해제를 요청하는 인증된 소스 사용자의 id입니다.
targetUserIdstring소스 사용자가 음소거 해제를 요청하는 대상 사용자의 id입니다.

반환값

Promise<MuteUserMutationResponse> API 응답으로 해결되는 Promise

정의된 위치

users/client.ts:2062

blockDms

blockDms(id): Promise<UsersDMBlockCreateResponse> DM 차단 인증된 사용자가 특정 사용자의 ID를 지정하여 해당 사용자와의 다이렉트 메시지를 주고받지 못하도록 차단합니다.

매개변수

이름타입설명
idstring인증된 사용자가 DM 차단을 요청하는 대상 사용자의 id입니다.

반환값

Promise<UsersDMBlockCreateResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:2111

getFollowedLists

getFollowedLists(id, options?): Promise<Get2UsersIdFollowedListsResponse> 팔로우한 Lists 가져오기 특정 사용자의 ID를 통해 해당 사용자가 팔로우 중인 Lists를 조회합니다.

매개변수

이름타입설명
idstring조회할 사용자 id입니다.
optionsGetFollowedListsOptions-

반환

Promise<Get2UsersIdFollowedListsResponse> API 응답으로 이행되는 Promise

정의

users/client.ts:2149

followList

followList(id, options?): Promise<ListFollowedResponse> 리스트 팔로우 인증된 사용자가 ID로 지정된 특정 리스트를 팔로우합니다.

매개변수

이름타입설명
idstring해당 목록을 팔로우할 인증된 소스 사용자(User)의 id입니다.
optionsFollowListOptions-

반환값

Promise<ListFollowedResponse> API 응답으로 해석(resolve)되는 Promise

정의됨

users/client.ts:2223

getByIds

getByIds(ids, options?): Promise<Get2UsersResponse> ID로 사용자 가져오기 여러 사용자의 상세 정보를 해당 ID로 가져옵니다.

매개변수

이름타입설명
idsany[]쉼표로 구분된 사용자 ID 목록입니다. 최대 100개의 ID를 지정할 수 있습니다.
optionsGetByIdsOptions-

반환

Promise<Get2UsersResponse> API 응답으로 이행되는 Promise

정의됨

users/client.ts:2271

getMe

getMe(options?): Promise<Get2UsersMeResponse> 내 사용자 정보 가져오기 인증된 사용자의 상세 정보를 조회합니다.

매개변수

이름타입
optionsGetMeOptions

반환값

Promise<Get2UsersMeResponse> API 응답으로 resolve되는 Promise

정의된 위치

users/client.ts:2331

unblockDms

unblockDms(id): Promise<UsersDMUnBlockCreateResponse> DM 차단 해제 인증된 사용자가 특정 사용자의 ID를 기준으로 해당 사용자와의 다이렉트 메시지를 차단 해제합니다.

매개변수

이름유형설명
idstring인증된 사용자가 DM 차단 해제를 요청하는 대상 사용자(User)의 id.

반환

Promise<UsersDMUnBlockCreateResponse> API 응답으로 해결되는 Promise

정의된 위치

users/client.ts:2388

getMuting

getMuting(id, options?): Promise<Get2UsersIdMutingResponse> 뮤트 목록 가져오기 인증된 사용자가 뮤트한 사용자 목록을 가져옵니다.

매개변수

이름유형설명
idstring결과를 반환할 인증된 소스 사용자(User)의 id입니다.
optionsGetMutingOptions-

반환

Promise<Get2UsersIdMutingResponse> API 응답으로 이행되는 Promise

정의된 위치

users/client.ts:2426

muteUser

muteUser(id, options?): Promise<MuteUserMutationResponse> 사용자 음소거 인증된 사용자가 지정한 사용자 ID를 기준으로 해당 사용자를 음소거합니다.

매개변수

이름타입설명
idstring대상 사용자의 음소거를 요청하는 인증된 소스 사용자의 id입니다.
optionsMuteUserOptions-

반환

Promise<MuteUserMutationResponse> API 응답으로 resolve되는 Promise

정의

users/client.ts:2500

getPosts

getPosts(id, options?): Promise<Get2UsersIdTweetsResponse> Post 가져오기 특정 사용자의 ID로 해당 사용자가 작성한 Post 목록을 가져옵니다.

매개변수

이름타입설명
idstring조회할 사용자 id.
optionsGetPostsOptions-

반환

Promise<Get2UsersIdTweetsResponse> API 응답으로 해석(resolve)되는 Promise

정의된 위치

users/client.ts:2548

deleteBookmark

deleteBookmark(id, tweetId): Promise<BookmarkMutationResponse> 북마크 삭제 인증된 사용자의 북마크에서 해당 ID의 Post를 제거합니다.

매개변수

이름타입설명
idstring북마크에서 항목을 제거하려는 인증된 소스 사용자의 ID입니다.
tweetIdstring소스 사용자가 북마크에서 제거하려는 Post의 ID입니다.

반환

Promise<BookmarkMutationResponse> API 응답으로 이행되는 Promise

정의된 위치

users/client.ts:2674

getByUsernames

getByUsernames(usernames, options?): Promise<Get2UsersByResponse> 사용자명으로 사용자 가져오기 여러 사용자의 세부 정보를 사용자명으로 조회합니다.

매개변수

이름유형설명
usernamesany[]쉼표로 구분된 사용자 이름 목록입니다.
optionsGetByUsernamesOptions-

반환

Promise<Get2UsersByResponse> API 응답으로 resolve되는 Promise

정의 위치

users/client.ts:2717

getByUsername

getByUsername(username, options?): Promise<Get2UsersByUsernameUsernameResponse> username으로 사용자 조회 username으로 특정 사용자의 상세 정보를 조회합니다.

매개변수

이름유형설명
usernamestring사용자명.
optionsGetByUsernameOptions-

반환값

Promise<Get2UsersByUsernameUsernameResponse> API 응답으로 이행되는 Promise

정의된 위치

users/client.ts:2781

getBookmarkFolders

getBookmarkFolders(id, options?): Promise<BookmarkFoldersResponse> Bookmark 폴더 가져오기 인증된 사용자가 만든 Bookmark 폴더 목록을 가져옵니다.

매개변수

이름유형설명
idstring결과를 반환할 인증된 소스 사용자의 id입니다.
optionsGetBookmarkFoldersOptions-

반환

Promise<BookmarkFoldersResponse> API 응답으로 이행되는 Promise

정의 위치

users/client.ts:2843
search(query, options?): Promise<Get2UsersSearchResponse> 사용자 검색 검색 쿼리와 일치하는 사용자 목록을 반환합니다.

매개변수

이름타입설명
queryany사용자를 검색할 때 사용하는 쿼리 문자열입니다.
optionsSearchOptions-

반환값

Promise<Get2UsersSearchResponse> API 응답으로 resolve되는 Promise입니다.

정의된 위치

users/client.ts:2899

getTimeline

getTimeline(id, options?): Promise<Get2UsersIdTimelinesReverseChronologicalResponse> 타임라인 가져오기 인증된 사용자의 타임라인에서 최신순(역순 연대기)으로 정렬된 Post 목록을 반환합니다.

매개변수

이름타입설명
idstring인증된 소스 User의 역순(최신순) 타임라인 Post 목록을 조회할 대상의 id입니다.
optionsGetTimelineOptions-

반환

Promise<Get2UsersIdTimelinesReverseChronologicalResponse> API 응답으로 resolve되는 Promise

정의

users/client.ts:2975

getOwnedLists

getOwnedLists(id, options?): Promise<Get2UsersIdOwnedListsResponse> 소유한 리스트 가져오기 특정 사용자의 ID로 그 사용자가 소유한 리스트 목록을 조회합니다.

매개변수

이름유형설명
idstring조회할 사용자 id.
optionsGetOwnedListsOptions-

반환

Promise<Get2UsersIdOwnedListsResponse> API 응답으로 이행되는 Promise

정의 위치

users/client.ts:3097