Skip to main content
Client for posts operations This client provides methods for interacting with the posts endpoints of the X API. It handles authentication, request formatting, and response parsing for all posts related operations.

Constructors

constructor

new PostsClient(client): PostsClient Creates a new posts client instance

Parameters

Returns

PostsClient

Defined in

posts/client.ts:789

Methods

getInsights28hr

getInsights28hr(tweetIds, granularity, requestedMetrics, options): Promise<Response> Get 28-hour Post insights Retrieves engagement metrics for specified Posts over the last 28 hours.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2Insights28hrResponse>

Defined in

posts/client.ts:863

getAnalytics

getAnalytics(ids, endTime, startTime, granularity, options): Promise<Response> Get Post analytics Retrieves analytics data for specified Posts within a defined time range.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Analytics>

Defined in

posts/client.ts:1077

getReposts

getReposts(id, options): Promise<Response> Get Reposts Retrieves a list of Posts that repost a specific Post by its ID.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsIdRetweetsResponse>

Defined in

posts/client.ts:1284

searchRecent

searchRecent(query, options): Promise<Response> Search recent Posts Retrieves Posts from the last 7 days matching a search query.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsSearchRecentResponse>

Defined in

posts/client.ts:1572

searchAll

searchAll(query, options): Promise<Response> Search all Posts Retrieves Posts from the full archive matching a search query.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsSearchAllResponse>

Defined in

posts/client.ts:1981

getByIds

getByIds(ids, options): Promise<Response> Get Posts by IDs Retrieves details of multiple Posts by their IDs.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsResponse>

Defined in

posts/client.ts:2378

create

create(body, options): Promise<Response> Create or Edit Post Creates a new Post for the authenticated user, or edits an existing Post when edit_options are provided.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<TweetCreateResponse>

Defined in

posts/client.ts:2633

getQuoted

getQuoted(id, options): Promise<Response> Get Quoted Posts Retrieves a list of Posts that quote a specific Post by its ID.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsIdQuoteTweetsResponse>

Defined in

posts/client.ts:2731

getCountsRecent

getCountsRecent(query, options): Promise<Response> Get count of recent Posts Retrieves the count of Posts from the last 7 days matching a search query.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsCountsRecentResponse>

Defined in

posts/client.ts:3038

hideReply

hideReply(tweetId, options): Promise<Response> Hide reply Hides or unhides a reply to a conversation owned by the authenticated user.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<TweetHideResponse>

Defined in

posts/client.ts:3311

getInsightsHistorical

getInsightsHistorical(tweetIds, endTime, startTime, granularity, requestedMetrics, options): Promise<Response> Get historical Post insights Retrieves historical engagement metrics for specified Posts within a defined time range.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2InsightsHistoricalResponse>

Defined in

posts/client.ts:3464

getCountsAll

getCountsAll(query, options): Promise<Response> Get count of all Posts Retrieves the count of Posts matching a search query from the full archive.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsCountsAllResponse>

Defined in

posts/client.ts:3692

getById

getById(id, options): Promise<Response> Get Post by ID Retrieves details of a specific Post by its ID.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsIdResponse>

Defined in

posts/client.ts:3965

delete

delete(id, options): Promise<Response> Delete Post Deletes a specific Post by its ID, if owned by the authenticated user.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<TweetDeleteResponse>

Defined in

posts/client.ts:4215

getLikingUsers

getLikingUsers(id, options): Promise<Response> Get Liking Users Retrieves a list of Users who liked a specific Post by its ID.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsIdLikingUsersResponse>

Defined in

posts/client.ts:4319

getRepostedBy

getRepostedBy(id, options): Promise<Response> Get Reposted by Retrieves a list of Users who reposted a specific Post by its ID.

Parameters

Returns

Promise<Response> Promise resolving to the API response, or raw Response if requestOptions.raw is true

Defined in

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

Parameters

Returns

Promise<Get2TweetsIdRetweetedByResponse>

Defined in

posts/client.ts:4538