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