PostsClient

게시물 관련 작업을 위한 Client 이 Client는 X API의 게시물 엔드포인트와 상호 작용하기 위한 메서드를 제공합니다. 인증, 요청 형식 지정, 응답 파싱을 처리하여 게시물 관련 모든 작업을 지원합니다.

생성자

constructor

• new PostsClient(client): PostsClient 새 PostsClient 인스턴스를 생성합니다

매개변수

이름	타입	설명
`client`	`Client`	주요 X API Client 인스턴스

반환 값

PostsClient

정의된 위치

posts/client.ts:789

메서드

getInsights28hr

▸ getInsights28hr(tweetIds, granularity, requestedMetrics, options): Promise<Response> 28시간 포스트 인사이트 가져오기
지정된 포스트에 대해 지난 28시간 동안의 참여 메트릭을 조회합니다.

매개변수

Name	Type	Description
`tweetIds`	`any`[]	28시간 메트릭용 게시물 id 목록입니다.
`granularity`	`string`	메트릭 응답의 세분화 수준입니다.
`requestedMetrics`	`any`[]	과거 데이터 조회를 위한 메트릭을 지정합니다.
`options`	`GetInsights28hrOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우 원시 Response가 반환됩니다

정의된 위치

posts/client.ts:842 ▸ getInsights28hr(tweetIds, granularity, requestedMetrics, options?): Promise<Get2Insights28hrResponse>

매개변수

이름	타입
`tweetIds`	`any`[]
`granularity`	`string`
`requestedMetrics`	`any`[]
`options?`	`GetInsights28hrOptions`

반환

Promise<Get2Insights28hrResponse>

정의 위치

posts/client.ts:863

getAnalytics

▸ getAnalytics(ids, endTime, startTime, granularity, options): Promise<Response> 게시물 분석 가져오기 정의된 기간 내 지정된 포스트에 대한 분석 데이터를 가져옵니다.

매개변수

Name	Type	Description
`ids`	`any`[]	쉼표로 구분된 게시물 ID 목록입니다. 한 요청당 최대 100개까지 허용됩니다.
`endTime`	`string`	YYYY-MM-DDTHH:mm:ssZ. 시간 범위의 종료 시점을 나타내는 UTC 타임스탬프입니다.
`startTime`	`string`	YYYY-MM-DDTHH:mm:ssZ. 시간 범위의 시작 시점을 나타내는 UTC 타임스탬프입니다.
`granularity`	`string`	검색 카운트 결과의 집계 단위입니다.
`options`	`GetAnalyticsOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise입니다. 단, requestOptions.raw가 true이면 원시 Response가 반환됩니다.

정의 위치

posts/client.ts:1052 ▸ getAnalytics(ids, endTime, startTime, granularity, options?): Promise<Analytics>

매개변수

이름	타입
`ids`	`any`[]
`endTime`	`string`
`startTime`	`string`
`granularity`	`string`
`options?`	`GetAnalyticsOptions`

반환 값

Promise<Analytics>

정의 위치

posts/client.ts:1077

getReposts

▸ getReposts(id, options): Promise<Response> 리포스트 가져오기 특정 게시물의 id를 사용하여 해당 게시물을 리포스트한 포스트 목록을 조회합니다.

매개변수

Name	Type	Description
`id`	`string`	단일 게시물 ID입니다.
`options`	`GetRepostsOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우에는 원시 Response입니다

정의된 위치

posts/client.ts:1271 ▸ getReposts(id, options?): Promise<Get2TweetsIdRetweetsResponse>

매개변수

이름	type
`id`	`string`
`options?`	`GetRepostsOptions`

반환값

Promise<Get2TweetsIdRetweetsResponse>

정의된 위치

posts/client.ts:1284

searchRecent

▸ searchRecent(query, options): Promise<Response> 최근 포스트 검색 검색 쿼리와 일치하는 최근 7일간의 포스트를 조회합니다.

매개변수

Name	Type	Description
`query`	`string`	포스트를 매칭하기 위한 단일 쿼리/규칙/필터입니다. 최대 쿼리 길이는 https://t.co/rulelength 에서 확인하세요.
`options`	`SearchRecentOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우에는 원시 Response

정의 위치

posts/client.ts:1559 ▸ searchRecent(query, options?): Promise<Get2TweetsSearchRecentResponse>

매개변수

이름	type
`query`	`string`
`options?`	`SearchRecentOptions`

반환값

Promise<Get2TweetsSearchRecentResponse>

정의된 위치

posts/client.ts:1572

searchAll

▸ searchAll(query, options): Promise<Response> 모든 포스트 검색 검색 쿼리와 일치하는 전체 아카이브의 포스트를 조회합니다.

매개변수

Name	Type	Description
`query`	`string`	게시물을 일치시키기 위한 단일 쿼리/규칙/필터입니다. 최대 쿼리 길이를 확인하려면 https://t.co/rulelength를 참조하세요.
`options`	`SearchAllOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우에는 원본 Response입니다.

정의 위치

posts/client.ts:1968 ▸ searchAll(query, options?): Promise<Get2TweetsSearchAllResponse>

매개변수

이름	Type
`query`	`string`
`options?`	`SearchAllOptions`

반환값

Promise<Get2TweetsSearchAllResponse>

정의된 위치

posts/client.ts:1981

getByIds

▸ getByIds(ids, options): Promise<Response> id로 포스트 가져오기
여러 포스트의 id를 사용하여 각 포스트의 세부 정보를 조회합니다.

매개변수

Name	Type	Description
`ids`	`any`[]	쉼표로 구분된 게시물 ID 목록입니다. 한 번의 요청에서 최대 100개까지 허용됩니다.
`options`	`GetByIdsOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우 원시 Response

정의된 곳

posts/client.ts:2365 ▸ getByIds(ids, options?): Promise<Get2TweetsResponse>

매개변수

이름	타입
`ids`	`any`[]
`options?`	`GetByIdsOptions`

반환 값

Promise<Get2TweetsResponse>

정의된 위치

posts/client.ts:2378

create

▸ create(body, options): Promise<Response> 게시물 생성 또는 편집
인증된 사용자의 새 게시물을 생성하거나, edit_options가 제공된 경우 기존 게시물을 편집합니다.

매개변수

이름	타입	설명
`body`	`TweetCreateRequest`	요청 본문
`options`	`Object`	-
`options.requestOptions`	`Object`	-
`options.requestOptions.raw`	`true`	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise 또는 requestOptions.raw가 true인 경우에는 원시 Response

정의 위치

posts/client.ts:2622 ▸ create(body): Promise<TweetCreateResponse>

매개변수

이름	Type
`body`	`TweetCreateRequest`

반환

Promise<TweetCreateResponse>

정의된 위치

posts/client.ts:2633

getQuoted

▸ getQuoted(id, options): Promise<Response> 인용된 포스트 가져오기 지정한 id의 게시물을 인용한 포스트 목록을 가져옵니다.

매개변수

이름	type	설명
`id`	`string`	단일 게시물 ID입니다.
`options`	`GetQuotedOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우 원본 Response를 반환합니다

정의된 위치

posts/client.ts:2718 ▸ getQuoted(id, options?): Promise<Get2TweetsIdQuoteTweetsResponse>

매개변수

이름	타입
`id`	`string`
`options?`	`GetQuotedOptions`

반환

Promise<Get2TweetsIdQuoteTweetsResponse>

정의된 위치

posts/client.ts:2731

getCountsRecent

▸ getCountsRecent(query, options): Promise<Response> 최근 포스트 개수 가져오기 검색 쿼리와 일치하는, 최근 7일 이내 포스트 개수를 조회합니다.

Parameters

Name	Type	Description
`query`	`string`	포스트를 매칭하기 위한 단일 쿼리/규칙/필터입니다. 최대 쿼리 길이를 확인하려면 https://t.co/rulelength를 참고하세요.
`options`	`GetCountsRecentOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true이면 raw Response를 반환합니다

정의된 위치

posts/client.ts:3025 ▸ getCountsRecent(query, options?): Promise<Get2TweetsCountsRecentResponse>

매개변수

이름	type
`query`	`string`
`options?`	`GetCountsRecentOptions`

반환값

Promise<Get2TweetsCountsRecentResponse>

정의된 위치

posts/client.ts:3038

hideReply

▸ hideReply(tweetId, options): Promise<Response> 답글 숨기기 인증된 사용자가 소유한 대화에 달린 답글을 숨기거나 숨김을 해제합니다.

매개변수

Name	Type	Description
`tweetId`	`string`	숨기거나 숨김 해제하려는 답글의 ID입니다.
`options`	`HideReplyOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우 원시 Response

정의 위치

posts/client.ts:3298 ▸ hideReply(tweetId, options?): Promise<TweetHideResponse>

매개변수

이름	타입
`tweetId`	`string`
`options?`	`HideReplyOptions`

반환값

Promise<TweetHideResponse>

정의 위치

posts/client.ts:3311

getInsightsHistorical

▸ getInsightsHistorical(tweetIds, endTime, startTime, granularity, requestedMetrics, options): Promise<Response> 과거 게시물 인사이트 조회 지정된 포스트에 대해 설정된 기간 내의 과거 참여 지표를 반환합니다.

매개변수

Name	Type	Description
`tweetIds`	`any`[]	과거 메트릭 조회를 위한 PostIds 목록입니다.
`endTime`	`string`	YYYY-MM-DDTHH:mm:ssZ. 시간 범위의 끝을 나타내는 UTC 타임스탬프입니다.
`startTime`	`string`	YYYY-MM-DDTHH:mm:ssZ. 시간 범위의 시작을 나타내는 UTC 타임스탬프입니다.
`granularity`	`string`	메트릭 응답의 세분화 수준입니다.
`requestedMetrics`	`any`[]	과거 조회에 대해 요청할 메트릭입니다.
`options`	`GetInsightsHistoricalOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이거나, requestOptions.raw가 true인 경우 원본 Response입니다

정의 위치

posts/client.ts:3435 ▸ getInsightsHistorical(tweetIds, endTime, startTime, granularity, requestedMetrics, options?): Promise<Get2InsightsHistoricalResponse>

매개변수

이름	유형
`tweetIds`	`any`[]
`endTime`	`string`
`startTime`	`string`
`granularity`	`string`
`requestedMetrics`	`any`[]
`options?`	`GetInsightsHistoricalOptions`

반환

Promise<Get2InsightsHistoricalResponse>

정의된 위치

posts/client.ts:3464

getCountsAll

▸ getCountsAll(query, options): Promise<Response> 모든 포스트 개수 가져오기 전체 아카이브에서 검색 쿼리에 일치하는 포스트의 개수를 조회합니다.

매개변수

Name	Type	Description
`query`	`string`	포스트를 매칭하기 위한 단일 쿼리/규칙/필터입니다. 최대 쿼리 길이를 확인하려면 https://t.co/rulelength를 참고하세요.
`options`	`GetCountsAllOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이거나, requestOptions.raw가 true인 경우 원시 Response

정의된 위치

posts/client.ts:3679 ▸ getCountsAll(query, options?): Promise<Get2TweetsCountsAllResponse>

매개변수

이름	타입
`query`	`string`
`options?`	`GetCountsAllOptions`

반환

Promise<Get2TweetsCountsAllResponse>

정의된 위치

posts/client.ts:3692

getById

▸ getById(id, options): Promise<Response> ID로 게시물 조회
주어진 ID로 특정 게시물의 상세 정보를 조회합니다.

매개변수

Name	Type	Description
`id`	`string`	단일 게시물 id입니다.
`options`	`GetByIdOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이거나, requestOptions.raw가 true인 경우 원본 Response

정의 위치

posts/client.ts:3952 ▸ getById(id, options?): Promise<Get2TweetsIdResponse>

매개변수

이름	타입
`id`	`string`
`options?`	`GetByIdOptions`

반환값

Promise<Get2TweetsIdResponse>

정의된 위치

posts/client.ts:3965

delete

▸ delete(id, options): Promise<Response> 게시물 삭제 인증된 사용자가 소유한 경우, 해당 ID의 특정 게시물을 삭제합니다.

매개변수

Name	Type	Description
`id`	`string`	삭제할 게시물의 ID입니다.
`options`	`Object`	-
`options.requestOptions`	`Object`	-
`options.requestOptions.raw`	`true`	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise 또는 requestOptions.raw가 true인 경우 원시 Response

정의 위치

posts/client.ts:4202 ▸ delete(id): Promise<TweetDeleteResponse>

매개변수

이름	타입
`id`	`string`

반환 값

Promise<TweetDeleteResponse>

정의 위치

posts/client.ts:4215

getLikingUsers

▸ getLikingUsers(id, options): Promise<Response> 좋아요한 사용자 가져오기 특정 게시물의 id를 기준으로, 해당 게시물을 좋아요한 사용자 목록을 가져옵니다.

매개변수

이름	타입	설명
`id`	`string`	단일 게시물 ID입니다.
`options`	`GetLikingUsersOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환값

Promise<Response> API 응답으로 resolve되는 Promise이며, requestOptions.raw가 true인 경우 가공되지 않은 원본 Response를 그대로 반환합니다

정의 위치

posts/client.ts:4306 ▸ getLikingUsers(id, options?): Promise<Get2TweetsIdLikingUsersResponse>

매개변수

이름	타입
`id`	`string`
`options?`	`GetLikingUsersOptions`

반환값

Promise<Get2TweetsIdLikingUsersResponse>

정의된 위치

posts/client.ts:4319

getRepostedBy

▸ getRepostedBy(id, options): Promise<Response> 리포스트한 사용자 조회
특정 게시물 ID를 기준으로, 해당 게시물을 리포스트한 사용자 목록을 가져옵니다.

매개변수

Name	Type	Description
`id`	`string`	단일 게시물 ID입니다.
`options`	`GetRepostedByOptions` & { `requestOptions`: { `raw`: `true` } }	-

반환

Promise<Response> API 응답으로 resolve되는 Promise 또는 requestOptions.raw가 true인 경우 원시 Response

정의 위치

posts/client.ts:4525 ▸ getRepostedBy(id, options?): Promise<Get2TweetsIdRetweetedByResponse>

매개변수

이름	타입
`id`	`string`
`options?`	`GetRepostedByOptions`

반환값

Promise<Get2TweetsIdRetweetedByResponse>

정의된 위치

posts/client.ts:4538

API 참조 문서

Documentation Index

​생성자

​constructor

​매개변수

​반환 값

​정의된 위치

​메서드

​getInsights28hr

​매개변수

​반환값

​정의된 위치

​매개변수

​반환

​정의 위치

​getAnalytics

​매개변수

​반환값

​정의 위치

​매개변수

​반환 값

​정의 위치

​getReposts

​매개변수

​반환값

​정의된 위치

​매개변수

​반환값

​정의된 위치

​searchRecent

​매개변수

​반환값

​정의 위치

​매개변수

​반환값

​정의된 위치

​searchAll

​매개변수

​반환값

​정의 위치

​매개변수

​반환값

​정의된 위치

​getByIds

​매개변수

​반환값

​정의된 곳

​매개변수

​반환 값

​정의된 위치

​create

​매개변수

​반환값

​정의 위치

​매개변수

​반환

​정의된 위치

​getQuoted

​매개변수

​반환

​정의된 위치

​매개변수

​반환

​정의된 위치

​getCountsRecent

​Parameters

​반환값

​정의된 위치

​매개변수

​반환값

​정의된 위치

​hideReply

​매개변수

​반환값

​정의 위치

​매개변수

​반환값

​정의 위치

​getInsightsHistorical

​매개변수

생성자

constructor

매개변수

반환 값

정의된 위치

메서드

getInsights28hr

매개변수

반환값

정의된 위치

매개변수

반환

정의 위치

getAnalytics

매개변수

반환값

정의 위치

매개변수

반환 값

정의 위치

getReposts

매개변수

반환값

정의된 위치

매개변수

반환값

정의된 위치

searchRecent

매개변수

반환값

정의 위치

매개변수

반환값

정의된 위치

searchAll

매개변수

반환값

정의 위치

매개변수

반환값

정의된 위치

getByIds

매개변수

반환값

정의된 곳

매개변수

반환 값

정의된 위치

create

매개변수

반환값

정의 위치

매개변수

반환

정의된 위치

getQuoted

매개변수

반환

정의된 위치

매개변수

반환

정의된 위치

getCountsRecent

Parameters

반환값

정의된 위치

매개변수

반환값

정의된 위치

hideReply

매개변수

반환값

정의 위치

매개변수

반환값

정의 위치

getInsightsHistorical

매개변수

반환값

정의 위치