x-twitter-scraper 0.12.4 → 0.13.0

package/resources/x/users/users.d.ts

@@ -7,16 +7,16 @@ import { RequestOptions } from "../../../internal/request-options.js";
 export declare class Users extends APIResource {
     follow: FollowAPI.Follow;
     /**
-     * Get user profile with follower counts and verification
+     * Returns one public profile with counts and verification details.
      *
      * @example
      * ```ts
      * const userProfile = await client.x.users.retrieve('id');
      * ```
      */
-    retrieve(id: string, options?: RequestOptions): APIPromise<Shared.UserProfile>;
+    retrieve(id: string, query?: UserRetrieveParams | null | undefined, options?: RequestOptions): APIPromise<Shared.UserProfile>;
     /**
-     * Remove follower
+     * Removes a follower from a connected X account.
      *
      * @example
      * ```ts
@@ -28,18 +28,64 @@ export declare class Users extends APIResource {
      */
     removeFollower(id: string, params: UserRemoveFollowerParams, options?: RequestOptions): APIPromise<UserRemoveFollowerResponse>;
     /**
-     * Look up multiple users by IDs in one call
+     * Returns the accounts an organization lists as its affiliates, in X's order. An
+     * account without affiliates returns an empty list.
      *
      * @example
      * ```ts
-     * const response = await client.x.users.retrieveBatch({
-     *   ids: 'ids',
-     * });
+     * const paginatedUsers =
+     *   await client.x.users.retrieveAffiliates('id');
+     * ```
+     */
+    retrieveAffiliates(id: string, query?: UserRetrieveAffiliatesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
+    /**
+     * Returns the posts on the user's Articles tab, newest first. Each post's
+     * `article` holds the Article's ID, title, preview, cover & dates. Read the full
+     * text with GET /x/articles/{tweetId}.
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets =
+     *   await client.x.users.retrieveArticles('id');
+     * ```
+     */
+    retrieveArticles(id: string, query?: UserRetrieveArticlesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
+    /**
+     * Returns public profiles for up to 100 user IDs, usernames or profile links. Send
+     * ids or usernames, not both. Each returned profile costs 1 credit.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveBatch();
+     * ```
+     */
+    retrieveBatch(query?: UserRetrieveBatchParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveBatchResponse>;
+    /**
+     * Returns the newest posts of up to 20 users, named by user ID, username or
+     * profile link, in the order named. Send ids or usernames, not both. Each post
+     * costs 1 credit. A user in unavailable_ids or unprocessed_ids costs nothing.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveBatchTweets();
+     * ```
+     */
+    retrieveBatchTweets(query?: UserRetrieveBatchTweetsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveBatchTweetsResponse>;
+    /**
+     * Returns the user IDs of the selected user's followers, newest first, up to 5,000
+     * a page. Use it when you need IDs only. Each ID costs 1 credit.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveFollowerIds(
+     *   'id',
+     * );
      * ```
      */
-    retrieveBatch(query: UserRetrieveBatchParams, options?: RequestOptions): APIPromise<UserRetrieveBatchResponse>;
+    retrieveFollowerIds(id: string, query?: UserRetrieveFollowerIDsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowerIDsResponse>;
     /**
-     * List followers of a user
+     * Returns public follower profiles for the selected user, newest first. x.com puts
+     * some promoted followers first; Xquik doesn't.
      *
      * @example
      * ```ts
@@ -50,7 +96,7 @@ export declare class Users extends APIResource {
      */
     retrieveFollowers(id: string, query?: UserRetrieveFollowersParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowersResponse>;
     /**
-     * List mutual followers between you and a user
+     * Mutuals your X account sees, else 424 `account_required`.
      *
      * @example
      * ```ts
@@ -60,7 +106,7 @@ export declare class Users extends APIResource {
      */
     retrieveFollowersYouKnow(id: string, query?: UserRetrieveFollowersYouKnowParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
     /**
-     * List accounts a user follows
+     * Returns public profiles followed by the selected user.
      *
      * @example
      * ```ts
@@ -71,7 +117,44 @@ export declare class Users extends APIResource {
      */
     retrieveFollowing(id: string, query?: UserRetrieveFollowingParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowingResponse>;
     /**
-     * List tweets liked by a user
+     * Returns the user IDs of the accounts the selected user follows, newest first, up
+     * to 5,000 a page. Use it when you need IDs only. Each ID costs 1 credit.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveFollowingIds(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieveFollowingIds(id: string, query?: UserRetrieveFollowingIDsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowingIDsResponse>;
+    /**
+     * Returns the posts on the user's Highlights tab, in X's order. An account without
+     * highlights returns an empty list.
+     *
+     * @example
+     * ```ts
+     * const paginatedTweets =
+     *   await client.x.users.retrieveHighlights('id');
+     * ```
+     */
+    retrieveHighlights(id: string, query?: UserRetrieveHighlightsParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
+    /**
+     * Returns engagement insights for one profile: engagement rate, averages per post
+     * and posting rate, from its counts and its last 20 posts. Reposts and the pinned
+     * post stay out of the averages. Each report costs 1 credit, whatever it reads.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveInsights(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieveInsights(id: string, query?: UserRetrieveInsightsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveInsightsResponse>;
+    /**
+     * Your X account's likes, else 424 `account_required`. Others' likes get 424
+     * `likes_unavailable`.
      *
      * @example
      * ```ts
@@ -82,7 +165,40 @@ export declare class Users extends APIResource {
      */
     retrieveLikes(id: string, query?: UserRetrieveLikesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * List media tweets posted by a user
+     * Returns the public X Lists that include the selected user, as the profile's List
+     * memberships page shows them. Each List costs 1 credit. A protected account
+     * answers 403.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.x.users.retrieveListMemberships('id');
+     * ```
+     */
+    retrieveListMemberships(id: string, query?: UserRetrieveListMembershipsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveListMembershipsResponse>;
+    /**
+     * Returns the public X Lists the selected user created, in X's order, as the
+     * profile's Lists tab shows them. Each List costs 1 credit. A protected account
+     * answers 403.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveLists('id');
+     * ```
+     */
+    retrieveLists(id: string, query?: UserRetrieveListsParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveListsResponse>;
+    /**
+     * Says whether one user is broadcasting live video on X right now, with their
+     * latest broadcast, live or ended. Each check costs 1 credit.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.retrieveLive('id');
+     * ```
+     */
+    retrieveLive(id: string, query?: UserRetrieveLiveParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveLiveResponse>;
+    /**
+     * Returns public media posts from the selected user.
      *
      * @example
      * ```ts
@@ -93,7 +209,7 @@ export declare class Users extends APIResource {
      */
     retrieveMedia(id: string, query?: UserRetrieveMediaParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * List tweets mentioning a user
+     * Returns public posts mentioning the selected user.
      *
      * @example
      * ```ts
@@ -103,9 +219,9 @@ export declare class Users extends APIResource {
      */
     retrieveMentions(id: string, query?: UserRetrieveMentionsParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * Returns target-authored posts and replies. Omit mode for automatic maximum
-     * coverage. Pass next_cursor unchanged. Unprefixed cursors stay legacy. Excludes
-     * other-author context.
+     * Returns target-authored posts & replies, without other authors' context. Omit
+     * mode for automatic maximum coverage. Pass next_cursor unchanged; unprefixed
+     * cursors are legacy. It never opens with the pinned tweet.
      *
      * @example
      * ```ts
@@ -115,7 +231,7 @@ export declare class Users extends APIResource {
      */
     retrieveReplies(id: string, query?: UserRetrieveRepliesParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * Search users by name or username
+     * Returns public profiles matching a name or username.
      *
      * @example
      * ```ts
@@ -126,8 +242,36 @@ export declare class Users extends APIResource {
      */
     retrieveSearch(query: UserRetrieveSearchParams, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
     /**
-     * Omit mode for automatic maximum coverage. Pass next_cursor unchanged. Unprefixed
-     * cursors use legacy pagination. Shape and billing stay the same.
+     * Returns the public accounts X lists as similar to the selected user, in X's
+     * order. X can list slightly different accounts on each call. Each account costs 1
+     * credit.
+     *
+     * @example
+     * ```ts
+     * const paginatedUsers = await client.x.users.retrieveSimilar(
+     *   'id',
+     * );
+     * ```
+     */
+    retrieveSimilar(id: string, query?: UserRetrieveSimilarParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
+    /**
+     * Returns the creators the selected user subscribes to, in X's order. An account
+     * that hides its subscriptions returns an empty list.
+     *
+     * @example
+     * ```ts
+     * const paginatedUsers =
+     *   await client.x.users.retrieveSubscriptions('id');
+     * ```
+     */
+    retrieveSubscriptions(id: string, query?: UserRetrieveSubscriptionsParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
+    /**
+     * For the newest posts of 2 to 20 users, use getBatchUserTweets. For more, use
+     * createExtraction with tweet_search_extractor & targetUsernames. Omit mode for
+     * automatic maximum coverage. Pass next_cursor unchanged; unprefixed cursors are
+     * legacy. The first page opens with the pinned tweet, flagged isPinned, unless
+     * replies are included. Rows stay newest first. x.com's Posts tab groups
+     * self-threads & hides reposts; retweets=exclude drops reposts.
      *
      * @example
      * ```ts
@@ -138,7 +282,7 @@ export declare class Users extends APIResource {
      */
     retrieveTweets(id: string, query?: UserRetrieveTweetsParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * List verified followers of a user
+     * Returns verified public profiles following the selected user.
      *
      * @example
      * ```ts
@@ -147,11 +291,24 @@ export declare class Users extends APIResource {
      * ```
      */
     retrieveVerifiedFollowers(id: string, query?: UserRetrieveVerifiedFollowersParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveVerifiedFollowersResponse>;
+    /**
+     * Returns X's own translation of one profile's bio into the language you pick,
+     * with the links, mentions, and tags X places in the translated text. A profile
+     * without a bio returns translation null & a message, free of charge.
+     *
+     * @example
+     * ```ts
+     * const response = await client.x.users.translateBio('id', {
+     *   language: 'es',
+     * });
+     * ```
+     */
+    translateBio(id: string, query: UserTranslateBioParams, options?: RequestOptions): APIPromise<UserTranslateBioResponse>;
 }
 /**
- * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
- * the original Idempotency-Key returns this same record. Submit a new write only
- * when safeToRetry is true, using a new key.
+ * Durable write record. Poll statusUrl until terminal is true. Reusing its
+ * Idempotency-Key returns this record. Create another action only when safeToRetry
+ * is true.
  */
 export interface UserRemoveFollowerResponse {
     id: string;
@@ -159,7 +316,7 @@ export interface UserRemoveFollowerResponse {
      * Connected account selected for the write.
      */
     account: UserRemoveFollowerResponse.Account | null;
-    action: 'create_tweet' | 'delete_tweet' | 'like' | 'unlike' | 'retweet' | 'unretweet' | 'follow' | 'unfollow' | 'remove_follower' | 'send_dm' | 'upload_media' | 'update_profile' | 'update_avatar' | 'update_banner' | 'create_community' | 'delete_community' | 'join_community' | 'leave_community';
+    action: 'create_tweet' | 'delete_tweet' | 'like' | 'unlike' | 'retweet' | 'unretweet' | 'follow' | 'unfollow' | 'remove_follower' | 'send_dm' | 'delete_dm' | 'upload_media' | 'update_profile' | 'update_avatar' | 'update_banner' | 'create_community' | 'delete_community' | 'join_community' | 'leave_community';
     /**
      * plannedCredits is the approved maximum. chargedCredits comes from the settled
      * credit ledger. Pending or failed writes are not charged.
@@ -186,7 +343,7 @@ export interface UserRemoveFollowerResponse {
      */
     retryable: boolean;
     /**
-     * True only when no write was dispatched and a new idempotency key may be used.
+     * True only when X did not get the write and a new idempotency key may be used.
      */
     safeToRetry: boolean;
     sendDispatched: boolean;
@@ -225,6 +382,10 @@ export interface UserRemoveFollowerResponse {
      * retention deadline.
      */
     expiresAt?: string;
+    /**
+     * True when this answers a retry of an earlier request with the same
+     * Idempotency-Key.
+     */
     idempotent?: boolean;
     /**
      * Media count, kind, size, and billing details when used.
@@ -284,6 +445,9 @@ export declare namespace UserRemoveFollowerResponse {
      */
     interface NextAction {
         type: 'poll' | 'retry' | 'verify_result' | 'fix_request';
+        /**
+         * Milliseconds to wait before you poll or retry.
+         */
         afterMs?: number;
         requiresNewIdempotencyKey?: boolean;
         url?: string;
@@ -320,12 +484,15 @@ export declare namespace UserRemoveFollowerResponse {
     }
 }
 /**
- * Batch user lookup results. Duplicate requested IDs are ignored while preserving
- * first-seen order. unavailable_ids identifies processed IDs with no returned
- * profile. unprocessed_ids identifies IDs skipped when the available usage balance limited
- * processing.
+ * Batch lookup preserves first-seen order and ignores duplicates. The ID lists
+ * name the requested IDs or usernames. A profile link is named by its username.
  */
 export interface UserRetrieveBatchResponse {
+    /**
+     * Processed IDs that failed to load, in first-seen request order. They cost
+     * nothing. Retry them.
+     */
+    failed_ids: Array<string>;
     /**
      * Batch lookups never paginate.
      */
@@ -347,31 +514,65 @@ export interface UserRetrieveBatchResponse {
      */
     returned_count: number;
     /**
-     * Processed IDs with no returned profile, in first-seen request order.
+     * Processed IDs with no profile on X, in first-seen request order.
      */
     unavailable_ids: Array<string>;
     /**
-     * Requested IDs skipped because the available usage balance limited processing. Retry these
-     * IDs after adding balance.
+     * Requested IDs skipped because available credits limited processing. Retry these
+     * IDs after adding credits.
      */
     unprocessed_ids: Array<string>;
     users: Array<Shared.UserProfile>;
+    /**
+     * Profiles rejected by the requested filters.
+     */
+    filtered_count?: number;
+}
+/**
+ * Each user's newest posts, in the order the users were named, with the pinned
+ * post first. The ID lists name the requested IDs or usernames. A profile link is
+ * named by its username.
+ */
+export interface UserRetrieveBatchTweetsResponse {
+    /**
+     * Always false. The answer holds every post in 1 page.
+     */
+    has_next_page: false;
+    /**
+     * Always empty. The answer holds every post in 1 page.
+     */
+    next_cursor: string;
+    tweets: Array<Shared.SearchTweet>;
+    /**
+     * Users with no account on X or with protected posts, in first-seen request order.
+     * They cost nothing.
+     */
+    unavailable_ids: Array<string>;
+    /**
+     * Users the call did not read, in first-seen request order. Their read failed, the
+     * call ran out of time or credits ran out. They cost nothing. Send them again.
+     */
+    unprocessed_ids: Array<string>;
+}
+/**
+ * A page of user IDs without profiles. Follow next_cursor while the response
+ * reports more pages.
+ */
+export interface UserRetrieveFollowerIDsResponse {
+    has_next_page: boolean;
+    /**
+     * X user IDs, newest relationship first.
+     */
+    ids: Array<string>;
+    next_cursor: string;
 }
 /**
- * Paginated user profiles. No-mode follower, following, and verified follower
- * requests merge independent views automatically. Response fields, page size,
- * aliases, filters, and per-returned-profile billing stay unchanged. Existing
- * unprefixed cursors retain legacy behavior. Follow next_cursor while
- * has_next_page is true.
+ * A standard or terminal maximum-coverage relationship page.
  */
 export type UserRetrieveFollowersResponse = Shared.PaginatedUsers | UserRetrieveFollowersResponse.UserListCoverageResponse;
 export declare namespace UserRetrieveFollowersResponse {
     /**
-     * Paginated user profiles. No-mode follower, following, and verified follower
-     * requests merge independent views automatically. Response fields, page size,
-     * aliases, filters, and per-returned-profile billing stay unchanged. Existing
-     * unprefixed cursors retain legacy behavior. Follow next_cursor while
-     * has_next_page is true.
+     * Terminal relationship coverage response with diagnostics.
      */
     interface UserListCoverageResponse extends Omit<Shared.PaginatedUsers, 'has_next_page' | 'next_cursor'> {
         /**
@@ -387,52 +588,78 @@ export declare namespace UserRetrieveFollowersResponse {
          */
         interface Diagnostic {
             /**
-             * True when every strategy exhausted its source.
+             * True after all active strategies exhaust their sources. An empty read of the
+             * whole search window also ends its time slices.
              */
             complete: boolean;
+            /**
+             * Whole number from 0.
+             */
             cursorFailureCount: number;
             deadlineReached: boolean;
+            /**
+             * Whole number from 0.
+             */
             duplicateCount: number;
+            /**
+             * Whole number from 0.
+             */
             failedStrategyCount: number;
+            /**
+             * Whole number from 0.
+             */
             malformedCount: number;
+            /**
+             * Whole number from 0.
+             */
             pagesFetched: number;
             /**
-             * Whether credits or the requested limit reduced output.
+             * True when credits or the requested limit reduce output.
              */
             responseTruncated: boolean;
             resultLimitReached: boolean;
             returnedUsers: number;
+            /**
+             * Whole number from 0.
+             */
             stalledStrategyCount: number;
             strategies: Array<Diagnostic.Strategy>;
             strategyCount: number;
             uniqueUsers: number;
         }
         namespace Diagnostic {
+            /**
+             * Result counts and stop reason for one relationship strategy.
+             */
             interface Strategy {
+                /**
+                 * Whole number from 0.
+                 */
                 duplicateCount: number;
+                /**
+                 * Whole number from 0.
+                 */
                 pagesFetched: number;
+                /**
+                 * Reason a coverage strategy stopped.
+                 */
                 stopReason: 'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
                 strategy: number;
+                /**
+                 * Whole number from 0.
+                 */
                 uniqueAdded: number;
             }
         }
     }
 }
 /**
- * Paginated user profiles. No-mode follower, following, and verified follower
- * requests merge independent views automatically. Response fields, page size,
- * aliases, filters, and per-returned-profile billing stay unchanged. Existing
- * unprefixed cursors retain legacy behavior. Follow next_cursor while
- * has_next_page is true.
+ * A standard or terminal maximum-coverage relationship page.
  */
 export type UserRetrieveFollowingResponse = Shared.PaginatedUsers | UserRetrieveFollowingResponse.UserListCoverageResponse;
 export declare namespace UserRetrieveFollowingResponse {
     /**
-     * Paginated user profiles. No-mode follower, following, and verified follower
-     * requests merge independent views automatically. Response fields, page size,
-     * aliases, filters, and per-returned-profile billing stay unchanged. Existing
-     * unprefixed cursors retain legacy behavior. Follow next_cursor while
-     * has_next_page is true.
+     * Terminal relationship coverage response with diagnostics.
      */
     interface UserListCoverageResponse extends Omit<Shared.PaginatedUsers, 'has_next_page' | 'next_cursor'> {
         /**
@@ -448,351 +675,2427 @@ export declare namespace UserRetrieveFollowingResponse {
          */
         interface Diagnostic {
             /**
-             * True when every strategy exhausted its source.
+             * True after all active strategies exhaust their sources. An empty read of the
+             * whole search window also ends its time slices.
              */
             complete: boolean;
+            /**
+             * Whole number from 0.
+             */
             cursorFailureCount: number;
             deadlineReached: boolean;
+            /**
+             * Whole number from 0.
+             */
             duplicateCount: number;
+            /**
+             * Whole number from 0.
+             */
             failedStrategyCount: number;
+            /**
+             * Whole number from 0.
+             */
             malformedCount: number;
+            /**
+             * Whole number from 0.
+             */
             pagesFetched: number;
             /**
-             * Whether credits or the requested limit reduced output.
+             * True when credits or the requested limit reduce output.
              */
             responseTruncated: boolean;
             resultLimitReached: boolean;
             returnedUsers: number;
+            /**
+             * Whole number from 0.
+             */
             stalledStrategyCount: number;
             strategies: Array<Diagnostic.Strategy>;
             strategyCount: number;
             uniqueUsers: number;
         }
         namespace Diagnostic {
+            /**
+             * Result counts and stop reason for one relationship strategy.
+             */
             interface Strategy {
+                /**
+                 * Whole number from 0.
+                 */
                 duplicateCount: number;
+                /**
+                 * Whole number from 0.
+                 */
                 pagesFetched: number;
+                /**
+                 * Reason a coverage strategy stopped.
+                 */
                 stopReason: 'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
                 strategy: number;
+                /**
+                 * Whole number from 0.
+                 */
                 uniqueAdded: number;
             }
         }
     }
 }
 /**
- * Paginated user profiles. No-mode follower, following, and verified follower
- * requests merge independent views automatically. Response fields, page size,
- * aliases, filters, and per-returned-profile billing stay unchanged. Existing
- * unprefixed cursors retain legacy behavior. Follow next_cursor while
- * has_next_page is true.
+ * A page of user IDs without profiles. Follow next_cursor while the response
+ * reports more pages.
  */
-export type UserRetrieveVerifiedFollowersResponse = Shared.PaginatedUsers | UserRetrieveVerifiedFollowersResponse.UserListCoverageResponse;
-export declare namespace UserRetrieveVerifiedFollowersResponse {
+export interface UserRetrieveFollowingIDsResponse {
+    has_next_page: boolean;
     /**
-     * Paginated user profiles. No-mode follower, following, and verified follower
-     * requests merge independent views automatically. Response fields, page size,
-     * aliases, filters, and per-returned-profile billing stay unchanged. Existing
-     * unprefixed cursors retain legacy behavior. Follow next_cursor while
-     * has_next_page is true.
+     * X user IDs, newest relationship first.
      */
-    interface UserListCoverageResponse extends Omit<Shared.PaginatedUsers, 'has_next_page' | 'next_cursor'> {
+    ids: Array<string>;
+    next_cursor: string;
+}
+export interface UserRetrieveInsightsResponse {
+    /**
+     * Engagement insights of one profile. Engagements are likes, replies, reposts and
+     * quotes. A rate is null when nothing divides it, such as a profile without posts
+     * of its own.
+     */
+    insights: UserRetrieveInsightsResponse.Insights;
+    /**
+     * Says why the report has counts only.
+     */
+    message?: string;
+}
+export declare namespace UserRetrieveInsightsResponse {
+    /**
+     * Engagement insights of one profile. Engagements are likes, replies, reposts and
+     * quotes. A rate is null when nothing divides it, such as a profile without posts
+     * of its own.
+     */
+    interface Insights {
         /**
-         * Coverage evidence across parallel relationship strategies.
+         * Whole days since the account joined X.
          */
-        diagnostic: UserListCoverageResponse.Diagnostic;
-        has_next_page?: false;
-        next_cursor?: '';
+        accountAgeDays: number | null;
+        /**
+         * Each count per post of the sample. Null without posts.
+         */
+        averages: Insights.Averages | null;
+        /**
+         * Engagements as a percent of views across the sample.
+         */
+        engagementPerView: number | null;
+        /**
+         * Average engagements per post, as a percent of followers.
+         */
+        engagementRate: number | null;
+        /**
+         * Followers.
+         */
+        followers: number;
+        /**
+         * Accounts the user follows.
+         */
+        following: number;
+        /**
+         * Posts the user has made.
+         */
+        posts: number;
+        /**
+         * Sampled posts per day, from the oldest one until now.
+         */
+        postsPerDay: number | null;
+        /**
+         * True when only the account's followers see its posts. The report then has its
+         * counts only.
+         */
+        postsPrivate: boolean;
+        /**
+         * The recent posts the averages read.
+         */
+        sample: Insights.Sample;
+        /**
+         * The sampled post with the most engagements.
+         */
+        topPostId: string | null;
+        /**
+         * ID of the profile the insights describe.
+         */
+        userId: string;
+        /**
+         * Username of that profile.
+         */
+        userName: string;
     }
-    namespace UserListCoverageResponse {
+    namespace Insights {
         /**
-         * Coverage evidence across parallel relationship strategies.
+         * Each count per post of the sample. Null without posts.
          */
-        interface Diagnostic {
+        interface Averages {
             /**
-             * True when every strategy exhausted its source.
+             * Bookmarks.
              */
-            complete: boolean;
-            cursorFailureCount: number;
-            deadlineReached: boolean;
-            duplicateCount: number;
-            failedStrategyCount: number;
-            malformedCount: number;
-            pagesFetched: number;
+            bookmarks: number;
             /**
-             * Whether credits or the requested limit reduced output.
+             * Likes, replies, reposts and quotes per post.
              */
-            responseTruncated: boolean;
-            resultLimitReached: boolean;
-            returnedUsers: number;
-            stalledStrategyCount: number;
-            strategies: Array<Diagnostic.Strategy>;
-            strategyCount: number;
-            uniqueUsers: number;
+            engagements: number;
+            /**
+             * Likes.
+             */
+            likes: number;
+            /**
+             * Quotes.
+             */
+            quotes: number;
+            /**
+             * Replies.
+             */
+            replies: number;
+            /**
+             * Reposts.
+             */
+            reposts: number;
+            /**
+             * Views.
+             */
+            views: number;
         }
-        namespace Diagnostic {
-            interface Strategy {
-                duplicateCount: number;
-                pagesFetched: number;
-                stopReason: 'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
-                strategy: number;
-                uniqueAdded: number;
-            }
+        /**
+         * The recent posts the averages read.
+         */
+        interface Sample {
+            /**
+             * When the newest of them went up.
+             */
+            newestAt: string | null;
+            /**
+             * When the oldest of them went up.
+             */
+            oldestAt: string | null;
+            /**
+             * Posts read.
+             */
+            posts: number;
         }
     }
 }
-export interface UserRemoveFollowerParams {
-    /**
-     * Body param: X account identifier (@username or account ID)
-     */
-    account: string;
-    /**
-     * Header param: Generate one unique value for each intended write. Reuse it only
-     * when retrying the exact same account, action, target, and payload. A reused key
-     * returns the original action. Reusing it with different input returns 409. Replay
-     * protection remains active for at least 90 days.
-     */
-    'Idempotency-Key': string;
-}
-export interface UserRetrieveBatchParams {
-    /**
-     * Comma-separated numeric user IDs (1-100 values). Duplicate IDs are ignored while
-     * preserving first-seen order.
-     */
-    ids: string;
+/**
+ * One page of public X Lists. Follow next_cursor while the response reports more
+ * pages. Each returned List costs 1 credit.
+ */
+export interface UserRetrieveListMembershipsResponse {
+    has_next_page: boolean;
+    lists: Array<UserRetrieveListMembershipsResponse.List>;
+    next_cursor: string;
 }
-export interface UserRetrieveFollowersParams {
+export declare namespace UserRetrieveListMembershipsResponse {
     /**
-     * Legacy cursor alias. Prefer cursor.
+     * Public X List with its owner's public profile. Leaves out what X tells the
+     * reading account, such as whether it follows the List.
      */
-    after?: string;
-    /**
-     * Match any comma-separated or line-separated bio term, ignoring case.
+    interface List {
+        /**
+         * Numeric ID of the List.
+         */
+        id: string;
+        /**
+         * Name the owner gave the List.
+         */
+        name: string;
+        /**
+         * URL of the banner the owner uploaded. Absent when the owner uploaded none.
+         */
+        bannerUrl?: string;
+        /**
+         * When the owner made the List.
+         */
+        createdAt?: string;
+        /**
+         * Banner the owner uploaded.
+         */
+        customBanner?: List.CustomBanner;
+        /**
+         * Banner X shows when the owner uploaded none. X picks it per reading account, so
+         * 2 calls can return different ones.
+         */
+        defaultBanner?: List.DefaultBanner;
+        /**
+         * About text of the List. Empty when the owner wrote none.
+         */
+        description?: string;
+        /**
+         * Avatar URLs of a few List members, which X may pick per request.
+         */
+        facepileUrls?: Array<string>;
+        /**
+         * Accounts on the List.
+         */
+        memberCount?: number;
+        /**
+         * Member count as X words it, such as 35 members.
+         */
+        membersContext?: string;
+        /**
+         * Public profile of the account that owns the List.
+         */
+        owner?: Shared.UserProfile;
+        /**
+         * Accounts that follow the List, which X calls followers.
+         */
+        subscriberCount?: number;
+        /**
+         * List page on x.com.
+         */
+        url?: string;
+    }
+    namespace List {
+        /**
+         * Banner the owner uploaded.
+         */
+        interface CustomBanner {
+            /**
+             * Banner image URL.
+             */
+            url: string;
+            /**
+             * Banner height in pixels.
+             */
+            height?: number;
+            /**
+             * Media ID of an uploaded banner.
+             */
+            mediaId?: string;
+            /**
+             * Stable media key of an uploaded banner.
+             */
+            mediaKey?: string;
+            /**
+             * Dominant colors of an uploaded banner and their shares.
+             */
+            palette?: Array<CustomBanner.Palette>;
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            salientRect?: CustomBanner.SalientRect;
+            /**
+             * Banner width in pixels.
+             */
+            width?: number;
+        }
+        namespace CustomBanner {
+            interface Palette {
+                /**
+                 * Share of the banner
+                 */
+                percentage?: number;
+                /**
+                 * The color's red, green and blue values.
+                 */
+                rgb?: Palette.Rgb;
+            }
+            namespace Palette {
+                /**
+                 * The color's red, green and blue values.
+                 */
+                interface Rgb {
+                    blue?: number;
+                    green?: number;
+                    red?: number;
+                }
+            }
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            interface SalientRect {
+                /**
+                 * Height of the marked area.
+                 */
+                height?: number;
+                /**
+                 * Pixels from the banner's left.
+                 */
+                left?: number;
+                /**
+                 * Pixels from the banner's top.
+                 */
+                top?: number;
+                /**
+                 * Width of the marked area.
+                 */
+                width?: number;
+            }
+        }
+        /**
+         * Banner X shows when the owner uploaded none. X picks it per reading account, so
+         * 2 calls can return different ones.
+         */
+        interface DefaultBanner {
+            /**
+             * Banner image URL.
+             */
+            url: string;
+            /**
+             * Banner height in pixels.
+             */
+            height?: number;
+            /**
+             * Media ID of an uploaded banner.
+             */
+            mediaId?: string;
+            /**
+             * Stable media key of an uploaded banner.
+             */
+            mediaKey?: string;
+            /**
+             * Dominant colors of an uploaded banner and their shares.
+             */
+            palette?: Array<DefaultBanner.Palette>;
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            salientRect?: DefaultBanner.SalientRect;
+            /**
+             * Banner width in pixels.
+             */
+            width?: number;
+        }
+        namespace DefaultBanner {
+            interface Palette {
+                /**
+                 * Share of the banner
+                 */
+                percentage?: number;
+                /**
+                 * The color's red, green and blue values.
+                 */
+                rgb?: Palette.Rgb;
+            }
+            namespace Palette {
+                /**
+                 * The color's red, green and blue values.
+                 */
+                interface Rgb {
+                    blue?: number;
+                    green?: number;
+                    red?: number;
+                }
+            }
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            interface SalientRect {
+                /**
+                 * Height of the marked area.
+                 */
+                height?: number;
+                /**
+                 * Pixels from the banner's left.
+                 */
+                left?: number;
+                /**
+                 * Pixels from the banner's top.
+                 */
+                top?: number;
+                /**
+                 * Width of the marked area.
+                 */
+                width?: number;
+            }
+        }
+    }
+}
+/**
+ * One page of public X Lists. Follow next_cursor while the response reports more
+ * pages. Each returned List costs 1 credit.
+ */
+export interface UserRetrieveListsResponse {
+    has_next_page: boolean;
+    lists: Array<UserRetrieveListsResponse.List>;
+    next_cursor: string;
+}
+export declare namespace UserRetrieveListsResponse {
+    /**
+     * Public X List with its owner's public profile. Leaves out what X tells the
+     * reading account, such as whether it follows the List.
+     */
+    interface List {
+        /**
+         * Numeric ID of the List.
+         */
+        id: string;
+        /**
+         * Name the owner gave the List.
+         */
+        name: string;
+        /**
+         * URL of the banner the owner uploaded. Absent when the owner uploaded none.
+         */
+        bannerUrl?: string;
+        /**
+         * When the owner made the List.
+         */
+        createdAt?: string;
+        /**
+         * Banner the owner uploaded.
+         */
+        customBanner?: List.CustomBanner;
+        /**
+         * Banner X shows when the owner uploaded none. X picks it per reading account, so
+         * 2 calls can return different ones.
+         */
+        defaultBanner?: List.DefaultBanner;
+        /**
+         * About text of the List. Empty when the owner wrote none.
+         */
+        description?: string;
+        /**
+         * Avatar URLs of a few List members, which X may pick per request.
+         */
+        facepileUrls?: Array<string>;
+        /**
+         * Accounts on the List.
+         */
+        memberCount?: number;
+        /**
+         * Member count as X words it, such as 35 members.
+         */
+        membersContext?: string;
+        /**
+         * Public profile of the account that owns the List.
+         */
+        owner?: Shared.UserProfile;
+        /**
+         * Accounts that follow the List, which X calls followers.
+         */
+        subscriberCount?: number;
+        /**
+         * List page on x.com.
+         */
+        url?: string;
+    }
+    namespace List {
+        /**
+         * Banner the owner uploaded.
+         */
+        interface CustomBanner {
+            /**
+             * Banner image URL.
+             */
+            url: string;
+            /**
+             * Banner height in pixels.
+             */
+            height?: number;
+            /**
+             * Media ID of an uploaded banner.
+             */
+            mediaId?: string;
+            /**
+             * Stable media key of an uploaded banner.
+             */
+            mediaKey?: string;
+            /**
+             * Dominant colors of an uploaded banner and their shares.
+             */
+            palette?: Array<CustomBanner.Palette>;
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            salientRect?: CustomBanner.SalientRect;
+            /**
+             * Banner width in pixels.
+             */
+            width?: number;
+        }
+        namespace CustomBanner {
+            interface Palette {
+                /**
+                 * Share of the banner
+                 */
+                percentage?: number;
+                /**
+                 * The color's red, green and blue values.
+                 */
+                rgb?: Palette.Rgb;
+            }
+            namespace Palette {
+                /**
+                 * The color's red, green and blue values.
+                 */
+                interface Rgb {
+                    blue?: number;
+                    green?: number;
+                    red?: number;
+                }
+            }
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            interface SalientRect {
+                /**
+                 * Height of the marked area.
+                 */
+                height?: number;
+                /**
+                 * Pixels from the banner's left.
+                 */
+                left?: number;
+                /**
+                 * Pixels from the banner's top.
+                 */
+                top?: number;
+                /**
+                 * Width of the marked area.
+                 */
+                width?: number;
+            }
+        }
+        /**
+         * Banner X shows when the owner uploaded none. X picks it per reading account, so
+         * 2 calls can return different ones.
+         */
+        interface DefaultBanner {
+            /**
+             * Banner image URL.
+             */
+            url: string;
+            /**
+             * Banner height in pixels.
+             */
+            height?: number;
+            /**
+             * Media ID of an uploaded banner.
+             */
+            mediaId?: string;
+            /**
+             * Stable media key of an uploaded banner.
+             */
+            mediaKey?: string;
+            /**
+             * Dominant colors of an uploaded banner and their shares.
+             */
+            palette?: Array<DefaultBanner.Palette>;
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            salientRect?: DefaultBanner.SalientRect;
+            /**
+             * Banner width in pixels.
+             */
+            width?: number;
+        }
+        namespace DefaultBanner {
+            interface Palette {
+                /**
+                 * Share of the banner
+                 */
+                percentage?: number;
+                /**
+                 * The color's red, green and blue values.
+                 */
+                rgb?: Palette.Rgb;
+            }
+            namespace Palette {
+                /**
+                 * The color's red, green and blue values.
+                 */
+                interface Rgb {
+                    blue?: number;
+                    green?: number;
+                    red?: number;
+                }
+            }
+            /**
+             * Area X marks as the subject of the banner, in pixels.
+             */
+            interface SalientRect {
+                /**
+                 * Height of the marked area.
+                 */
+                height?: number;
+                /**
+                 * Pixels from the banner's left.
+                 */
+                left?: number;
+                /**
+                 * Pixels from the banner's top.
+                 */
+                top?: number;
+                /**
+                 * Width of the marked area.
+                 */
+                width?: number;
+            }
+        }
+    }
+}
+/**
+ * Says whether a user broadcasts live video on X now. `broadcast` is their latest
+ * broadcast, live or ended, and null when X shows none.
+ */
+export interface UserRetrieveLiveResponse {
+    /**
+     * Latest broadcast, live or ended. Null when X shows none.
+     */
+    broadcast: UserRetrieveLiveResponse.Broadcast | null;
+    /**
+     * True while the user's latest broadcast is running.
+     */
+    live: boolean;
+    /**
+     * ID of the user.
+     */
+    userId: string;
+    /**
+     * Username of the user.
+     */
+    userName: string;
+}
+export declare namespace UserRetrieveLiveResponse {
+    /**
+     * X broadcast, a live video
+     */
+    interface Broadcast {
+        /**
+         * Broadcast ID
+         */
+        id: string;
+        /**
+         * Camera rotation in degrees
+         */
+        cameraRotation?: number;
+        /**
+         * X's code for who may chat
+         */
+        chatOption?: number;
+        /**
+         * Public X profile.
+         */
+        creator?: Shared.UserProfile;
+        /**
+         * When the broadcast ended
+         */
+        endedAt?: string;
+        /**
+         * Video height in pixels
+         */
+        height?: number;
+        /**
+         * Whether X offers a recording of the broadcast
+         */
+        isAvailableForReplay?: boolean;
+        /**
+         * Whether the video stream runs in high-latency mode
+         */
+        isHighLatency?: boolean;
+        /**
+         * Whether X marks the chat private
+         */
+        isPrivateChat?: boolean;
+        /**
+         * Whether the broadcaster edited the title of the replay
+         */
+        isTitleEdited?: boolean;
+        /**
+         * When the video stream last reached X
+         */
+        lastPingAt?: string;
+        /**
+         * X's media key for the video
+         */
+        mediaKey?: string;
+        /**
+         * Broadcaster, as X's live video service names the account
+         */
+        periscopeUser?: Broadcast.PeriscopeUser;
+        /**
+         * Image X shows before the broadcast starts
+         */
+        preLiveSlateUrl?: string;
+        /**
+         * When the broadcast was set to start
+         */
+        scheduledStart?: string;
+        /**
+         * What produced the video stream, as X names it
+         */
+        source?: string;
+        /**
+         * When the broadcast went live
+         */
+        startedAt?: string;
+        /**
+         * Such as NotStarted, Running or Ended, as X names it
+         */
+        state?: string;
+        /**
+         * Broadcast title
+         */
+        title?: string;
+        /**
+         * Accounts that watched, live or after
+         */
+        totalWatched?: number;
+        /**
+         * Accounts watching, as X counts them
+         */
+        totalWatching?: number;
+        /**
+         * Search tweet with author. Zero metrics may mean X omitted counts.
+         */
+        tweet?: Shared.SearchTweet;
+        /**
+         * ID of the post that announces the broadcast
+         */
+        tweetId?: string;
+        /**
+         * X's revision number of the broadcast
+         */
+        version?: number;
+        /**
+         * Video width in pixels
+         */
+        width?: number;
+    }
+    namespace Broadcast {
+        /**
+         * Broadcaster, as X's live video service names the account
+         */
+        interface PeriscopeUser {
+            /**
+             * Live video account ID
+             */
+            id?: string;
+            /**
+             * Live video display name
+             */
+            displayName?: string;
+            /**
+             * Live video avatar URL
+             */
+            profilePicture?: string;
+            /**
+             * Live video username
+             */
+            username?: string;
+        }
+    }
+}
+/**
+ * A standard or terminal maximum-coverage relationship page.
+ */
+export type UserRetrieveVerifiedFollowersResponse = Shared.PaginatedUsers | UserRetrieveVerifiedFollowersResponse.UserListCoverageResponse;
+export declare namespace UserRetrieveVerifiedFollowersResponse {
+    /**
+     * Terminal relationship coverage response with diagnostics.
+     */
+    interface UserListCoverageResponse extends Omit<Shared.PaginatedUsers, 'has_next_page' | 'next_cursor'> {
+        /**
+         * Coverage evidence across parallel relationship strategies.
+         */
+        diagnostic: UserListCoverageResponse.Diagnostic;
+        has_next_page?: false;
+        next_cursor?: '';
+    }
+    namespace UserListCoverageResponse {
+        /**
+         * Coverage evidence across parallel relationship strategies.
+         */
+        interface Diagnostic {
+            /**
+             * True after all active strategies exhaust their sources. An empty read of the
+             * whole search window also ends its time slices.
+             */
+            complete: boolean;
+            /**
+             * Whole number from 0.
+             */
+            cursorFailureCount: number;
+            deadlineReached: boolean;
+            /**
+             * Whole number from 0.
+             */
+            duplicateCount: number;
+            /**
+             * Whole number from 0.
+             */
+            failedStrategyCount: number;
+            /**
+             * Whole number from 0.
+             */
+            malformedCount: number;
+            /**
+             * Whole number from 0.
+             */
+            pagesFetched: number;
+            /**
+             * True when credits or the requested limit reduce output.
+             */
+            responseTruncated: boolean;
+            resultLimitReached: boolean;
+            returnedUsers: number;
+            /**
+             * Whole number from 0.
+             */
+            stalledStrategyCount: number;
+            strategies: Array<Diagnostic.Strategy>;
+            strategyCount: number;
+            uniqueUsers: number;
+        }
+        namespace Diagnostic {
+            /**
+             * Result counts and stop reason for one relationship strategy.
+             */
+            interface Strategy {
+                /**
+                 * Whole number from 0.
+                 */
+                duplicateCount: number;
+                /**
+                 * Whole number from 0.
+                 */
+                pagesFetched: number;
+                /**
+                 * Reason a coverage strategy stopped.
+                 */
+                stopReason: 'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
+                strategy: number;
+                /**
+                 * Whole number from 0.
+                 */
+                uniqueAdded: number;
+            }
+        }
+    }
+}
+export interface UserTranslateBioResponse {
+    /**
+     * Null when the profile has no bio.
+     */
+    translation: UserTranslateBioResponse.Translation | null;
+    /**
+     * Says why translation is null.
+     */
+    message?: string;
+}
+export declare namespace UserTranslateBioResponse {
+    /**
+     * Holds X's translation of one profile's bio into the requested language.
+     * `entities` holds the links, mentions, and tags with their offsets in the
+     * translated text, and is empty when the text has none.
+     */
+    interface Translation {
+        /**
+         * Lists hashtags, symbols, links, and mentions from tweet text.
+         */
+        entities: Translation.Entities;
+        /**
+         * Language code of the translated bio, in lower case.
+         */
+        language: string;
+        /**
+         * Translated bio.
+         */
+        text: string;
+        /**
+         * ID of the account whose bio X translated.
+         */
+        userId: string;
+        /**
+         * Username of that account.
+         */
+        userName: string;
+        /**
+         * Language code X detects in the bio, when it names one.
+         */
+        sourceLanguage?: string;
+    }
+    namespace Translation {
+        /**
+         * Lists hashtags, symbols, links, and mentions from tweet text.
+         */
+        interface Entities {
+            hashtags?: Array<Entities.Hashtag>;
+            smarttags?: Array<Entities.Smarttag>;
+            symbols?: Array<Entities.Symbol>;
+            timestamps?: Array<Entities.Timestamp>;
+            urls?: Array<Entities.URL>;
+            user_mentions?: Array<Entities.UserMention>;
+        }
+        namespace Entities {
+            /**
+             * Provides hashtag text and source offsets within a tweet.
+             */
+            interface Hashtag {
+                text: string;
+                indices?: Array<number>;
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                tag?: Hashtag.Tag;
+            }
+            namespace Hashtag {
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                interface Tag {
+                    /**
+                     * X's ID for the SmartTag.
+                     */
+                    id?: string;
+                    info?: Tag.Info;
+                }
+                namespace Tag {
+                    interface Info {
+                        info?: Info.Info;
+                    }
+                    namespace Info {
+                        interface Info {
+                            /**
+                             * Whether X marks the SmartTag active.
+                             */
+                            active?: boolean;
+                            name?: string;
+                            ticker?: string;
+                        }
+                    }
+                }
+            }
+            /**
+             * Indexed smart-tag, cashtag, or video timestamp metadata.
+             */
+            interface Smarttag {
+                indices?: Array<number>;
+                seconds?: number;
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                tag?: Smarttag.Tag;
+                text?: string;
+            }
+            namespace Smarttag {
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                interface Tag {
+                    /**
+                     * X's ID for the SmartTag.
+                     */
+                    id?: string;
+                    info?: Tag.Info;
+                }
+                namespace Tag {
+                    interface Info {
+                        info?: Info.Info;
+                    }
+                    namespace Info {
+                        interface Info {
+                            /**
+                             * Whether X marks the SmartTag active.
+                             */
+                            active?: boolean;
+                            name?: string;
+                            ticker?: string;
+                        }
+                    }
+                }
+            }
+            /**
+             * Indexed smart-tag, cashtag, or video timestamp metadata.
+             */
+            interface Symbol {
+                indices?: Array<number>;
+                seconds?: number;
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                tag?: Symbol.Tag;
+                text?: string;
+            }
+            namespace Symbol {
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                interface Tag {
+                    /**
+                     * X's ID for the SmartTag.
+                     */
+                    id?: string;
+                    info?: Tag.Info;
+                }
+                namespace Tag {
+                    interface Info {
+                        info?: Info.Info;
+                    }
+                    namespace Info {
+                        interface Info {
+                            /**
+                             * Whether X marks the SmartTag active.
+                             */
+                            active?: boolean;
+                            name?: string;
+                            ticker?: string;
+                        }
+                    }
+                }
+            }
+            /**
+             * Indexed smart-tag, cashtag, or video timestamp metadata.
+             */
+            interface Timestamp {
+                indices?: Array<number>;
+                seconds?: number;
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                tag?: Timestamp.Tag;
+                text?: string;
+            }
+            namespace Timestamp {
+                /**
+                 * X's SmartTag for a cashtag, smarttag or hashtag. Xquik leaves out X's trading
+                 * platforms, which differ by reader.
+                 */
+                interface Tag {
+                    /**
+                     * X's ID for the SmartTag.
+                     */
+                    id?: string;
+                    info?: Tag.Info;
+                }
+                namespace Tag {
+                    interface Info {
+                        info?: Info.Info;
+                    }
+                    namespace Info {
+                        interface Info {
+                            /**
+                             * Whether X marks the SmartTag active.
+                             */
+                            active?: boolean;
+                            name?: string;
+                            ticker?: string;
+                        }
+                    }
+                }
+            }
+            /**
+             * Provides shortened, display, and expanded URLs from tweet text.
+             */
+            interface URL {
+                display_url?: string;
+                expanded_url?: string;
+                indices?: Array<number>;
+                url?: string;
+            }
+            /**
+             * Provides profile identity and source offsets for a mention.
+             */
+            interface UserMention {
+                screen_name: string;
+                id_str?: string;
+                indices?: Array<number>;
+                name?: string;
+            }
+        }
+    }
+}
+export interface UserRetrieveParams {
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+}
+export interface UserRemoveFollowerParams {
+    /**
+     * Body param: X account identifier (@username or account ID)
+     */
+    account: string;
+    /**
+     * Header param: Use one unique value per intended write. Reuse it only for an
+     * identical retry. A matching retry returns the first answer again, with
+     * idempotent: true added. It keeps the first status, body & Retry-After. It sends
+     * nothing to X & charges nothing. While the first request runs, a retry returns
+     * 202 & the action. Different input returns 409. Protection lasts at least 90
+     * days.
+     */
+    'Idempotency-Key': string;
+}
+export interface UserRetrieveAffiliatesParams {
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
+    /**
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
+    /**
+     * Only return profiles with a location.
+     */
+    hasLocation?: boolean;
+    /**
+     * Only return profiles with a website.
+     */
+    hasWebsite?: boolean;
+    /**
+     * Match a location substring, ignoring case.
+     */
+    locationContains?: string;
+    /**
+     * Maximum follower count. Missing counts pass this maximum.
+     */
+    maxFollowers?: number;
+    /**
+     * Profiles may follow at most this many accounts.
+     */
+    maxFollowing?: number;
+    /**
+     * Maximum post count. maxPosts is also accepted.
+     */
+    maxStatuses?: number;
+    /**
+     * Minimum account age in whole days.
+     */
+    minAccountAgeDays?: number;
+    /**
+     * Minimum follower count. Filtering happens before billing.
+     */
+    minFollowers?: number;
+    /**
+     * Profiles must follow at least this many accounts.
+     */
+    minFollowing?: number;
+    /**
+     * Minimum post count. minPosts is also accepted.
+     */
+    minStatuses?: number;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Profiles to request from this page (1-200, default 200). Source, filters or
+     * credits can return fewer. Follow next_cursor for more pages. Aliases: limit,
+     * count, max_results, maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Match a username substring, ignoring case.
+     */
+    usernameContains?: string;
+    /**
+     * Only return verified profiles.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Match the verification type exactly, ignoring case.
+     */
+    verifiedType?: string;
+}
+export interface UserRetrieveArticlesParams {
+    /**
+     * Words or quoted phrases where any one can match. Separate with spaces, commas,
+     * or lines.
+     */
+    anyWords?: string;
+    /**
+     * Only return tweets from Blue-verified authors.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Cashtags separated by spaces, commas, or lines.
+     */
+    cashtags?: string;
+    /**
+     * Conversation ID filter.
+     */
+    conversationId?: string;
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Match this literal phrase, including any hyphens.
+     */
+    exactPhrase?: string;
+    /**
+     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+     */
+    excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Filter by author username.
+     */
+    fromUser?: string;
+    /**
+     * Hashtags separated by spaces, commas, or lines.
+     */
+    hashtags?: string;
+    /**
+     * Only replies to this tweet ID.
+     */
+    inReplyToTweetId?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
+     */
+    language?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
+     */
+    maxFaves?: number;
+    /**
+     * Return Tweets at or below this ID.
+     */
+    maxId?: string;
+    /**
+     * Maximum quotes threshold.
+     */
+    maxQuotes?: number;
+    /**
+     * Maximum replies threshold.
+     */
+    maxReplies?: number;
+    /**
+     * Maximum retweets threshold.
+     */
+    maxRetweets?: number;
+    /**
+     * Filter media. Aliases: has_video, has_media.
+     */
+    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    /**
+     * Filter tweets mentioning a username.
+     */
+    mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
+    /**
+     * Minimum quote count threshold.
+     */
+    minQuotes?: number;
+    /**
+     * Minimum replies threshold.
+     */
+    minReplies?: number;
+    /**
+     * Minimum retweets threshold.
+     */
+    minRetweets?: number;
+    /**
+     * Minimum view count threshold.
+     */
+    minViews?: number;
+    /**
+     * Only return native reposts.
+     */
+    nativeRetweets?: boolean;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Only when the caller requests a quote mode.
+     */
+    quotes?: 'include' | 'exclude' | 'only';
+    /**
+     * Only quotes of this tweet ID.
+     */
+    quotesOfTweetId?: string;
+    /**
+     * Reply mode. Exclude keeps own-thread replies.
+     */
+    replies?: 'include' | 'exclude' | 'only';
+    /**
+     * Only when the caller requests a repost mode.
+     */
+    retweets?: 'include' | 'exclude' | 'only';
+    /**
+     * Only retweets of this tweet ID.
+     */
+    retweetsOfTweetId?: string;
+    /**
+     * Start date in YYYY-MM-DD format, as a UTC day.
+     */
+    sinceDate?: string;
+    /**
+     * Return Tweets whose IDs exceed this ID.
+     */
+    sinceId?: string;
+    /**
+     * Filter replies sent to a username.
+     */
+    toUser?: string;
+    /**
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
+     */
+    untilDate?: string;
+    /**
+     * URL substring or domain filter.
+     */
+    url?: string;
+    /**
+     * Only return tweets from verified authors.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
+     */
+    withinTime?: string;
+}
+export interface UserRetrieveBatchParams {
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
+    /**
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
+    /**
+     * Only return profiles with a location.
+     */
+    hasLocation?: boolean;
+    /**
+     * Only return profiles with a website.
+     */
+    hasWebsite?: boolean;
+    /**
+     * Comma-separated numeric user IDs (1-100 values). Duplicate IDs are ignored while
+     * preserving first-seen order.
+     */
+    ids?: string;
+    /**
+     * Match a location substring, ignoring case.
+     */
+    locationContains?: string;
+    /**
+     * Maximum follower count. Missing counts pass this maximum.
+     */
+    maxFollowers?: number;
+    /**
+     * Profiles may follow at most this many accounts.
+     */
+    maxFollowing?: number;
+    /**
+     * Maximum post count. maxPosts is also accepted.
+     */
+    maxStatuses?: number;
+    /**
+     * Minimum account age in whole days.
+     */
+    minAccountAgeDays?: number;
+    /**
+     * Minimum follower count. Filtering happens before billing.
+     */
+    minFollowers?: number;
+    /**
+     * Profiles must follow at least this many accounts.
+     */
+    minFollowing?: number;
+    /**
+     * Minimum post count. minPosts is also accepted.
+     */
+    minStatuses?: number;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Match a username substring, ignoring case.
+     */
+    usernameContains?: string;
+    /**
+     * Comma-separated X usernames, with or without @, or profile links such as
+     * x.com/nasa (1-100 values), in place of ids. A name in another case is the same
+     * account.
+     */
+    usernames?: string;
+    /**
+     * Only return verified profiles.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Match the verification type exactly, ignoring case.
+     */
+    verifiedType?: string;
+}
+export interface UserRetrieveBatchTweetsParams {
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Comma-separated numeric user IDs (1-20 values). Duplicate IDs are ignored while
+     * preserving first-seen order.
+     */
+    ids?: string;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Posts per user (1-20, default 20). Credits can return fewer. Aliases: limit,
+     * count, max_results, maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Comma-separated X usernames, with or without @, or profile links such as
+     * x.com/nasa (1-20 values), in place of ids. A name in another case is the same
+     * account.
+     */
+    usernames?: string;
+}
+export interface UserRetrieveFollowerIDsParams {
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * User IDs to request from this page (1-5000, default 5000). Credits can return
+     * fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results,
+     * maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+}
+export interface UserRetrieveFollowersParams {
+    /**
+     * Legacy cursor alias. Prefer cursor.
+     */
+    after?: string;
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
+    /**
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Cursor from the previous response. Existing unprefixed cursors keep legacy
+     * standard behavior. Pages can be empty before more rows; follow next_cursor. Also
+     * read as next_cursor, next_token, pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Add each row's full profile, as GET /x/users/{id} returns it. Pages take several
+     * seconds longer.
+     */
+    enrichProfiles?: boolean;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
+    /**
+     * Only return profiles with a location.
+     */
+    hasLocation?: boolean;
+    /**
+     * Only return profiles with a website.
+     */
+    hasWebsite?: boolean;
+    /**
+     * Legacy page-size alias outside coverage mode. Coverage accepts 1-10000. Prefer
+     * pageSize.
+     */
+    limit?: number;
+    /**
+     * Match a location substring, ignoring case.
+     */
+    locationContains?: string;
+    /**
+     * Maximum follower count. Missing counts pass this maximum.
+     */
+    maxFollowers?: number;
+    /**
+     * Profiles may follow at most this many accounts.
+     */
+    maxFollowing?: number;
+    /**
+     * Most profiles 1 request reads, kept or dropped by the filters. A filter that
+     * keeps few profiles reads up to 65 s a request without it. The request then
+     * answers the profiles it kept, the count it dropped & the cursor to read on. Each
+     * request of a cursor may send its own value. Automatic mode only.
+     */
+    maxScan?: number;
+    /**
+     * Maximum post count. maxPosts is also accepted.
+     */
+    maxStatuses?: number;
+    /**
+     * Minimum account age in whole days.
+     */
+    minAccountAgeDays?: number;
+    /**
+     * Minimum follower count. Filtering happens before billing.
+     */
+    minFollowers?: number;
+    /**
+     * Profiles must follow at least this many accounts.
+     */
+    minFollowing?: number;
+    /**
+     * Minimum post count. minPosts is also accepted.
+     */
+    minStatuses?: number;
+    /**
+     * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
+     * Coverage returns diagnostics once and rejects cursors.
+     */
+    mode?: 'standard' | 'coverage';
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Up to 300 user profiles in automatic mode, 200 in standard. Sources can return
+     * fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results,
+     * maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Match a username substring, ignoring case.
+     */
+    usernameContains?: string;
+    /**
+     * Only return verified profiles.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Match the verification type exactly, ignoring case.
+     */
+    verifiedType?: string;
+}
+export interface UserRetrieveFollowersYouKnowParams {
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
+    /**
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
+    /**
+     * Only return profiles with a location.
+     */
+    hasLocation?: boolean;
+    /**
+     * Only return profiles with a website.
+     */
+    hasWebsite?: boolean;
+    /**
+     * Match a location substring, ignoring case.
+     */
+    locationContains?: string;
+    /**
+     * Maximum follower count. Missing counts pass this maximum.
+     */
+    maxFollowers?: number;
+    /**
+     * Profiles may follow at most this many accounts.
+     */
+    maxFollowing?: number;
+    /**
+     * Maximum post count. maxPosts is also accepted.
+     */
+    maxStatuses?: number;
+    /**
+     * Minimum account age in whole days.
+     */
+    minAccountAgeDays?: number;
+    /**
+     * Minimum follower count. Filtering happens before billing.
+     */
+    minFollowers?: number;
+    /**
+     * Profiles must follow at least this many accounts.
+     */
+    minFollowing?: number;
+    /**
+     * Minimum post count. minPosts is also accepted.
+     */
+    minStatuses?: number;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Profiles to request from this page (1-200, default 200). Source, filters or
+     * credits can return fewer. Follow next_cursor for more pages. Aliases: limit,
+     * count, max_results, maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Match a username substring, ignoring case.
+     */
+    usernameContains?: string;
+    /**
+     * Only return verified profiles.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Match the verification type exactly, ignoring case.
+     */
+    verifiedType?: string;
+}
+export interface UserRetrieveFollowingParams {
+    /**
+     * Legacy cursor alias. Prefer cursor.
+     */
+    after?: string;
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
+    /**
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Cursor from the previous response. Existing unprefixed cursors keep legacy
+     * standard behavior. Pages can be empty before more rows; follow next_cursor. Also
+     * read as next_cursor, next_token, pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Add each row's full profile, as GET /x/users/{id} returns it. Pages take several
+     * seconds longer.
+     */
+    enrichProfiles?: boolean;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
+    /**
+     * Only return profiles with a location.
+     */
+    hasLocation?: boolean;
+    /**
+     * Only return profiles with a website.
+     */
+    hasWebsite?: boolean;
+    /**
+     * Legacy page-size alias outside coverage mode. Coverage accepts 1-10000. Prefer
+     * pageSize.
+     */
+    limit?: number;
+    /**
+     * Match a location substring, ignoring case.
+     */
+    locationContains?: string;
+    /**
+     * Maximum follower count. Missing counts pass this maximum.
+     */
+    maxFollowers?: number;
+    /**
+     * Profiles may follow at most this many accounts.
+     */
+    maxFollowing?: number;
+    /**
+     * Most profiles 1 request reads, kept or dropped by the filters. A filter that
+     * keeps few profiles reads up to 65 s a request without it. The request then
+     * answers the profiles it kept, the count it dropped & the cursor to read on. Each
+     * request of a cursor may send its own value. Automatic mode only.
+     */
+    maxScan?: number;
+    /**
+     * Maximum post count. maxPosts is also accepted.
+     */
+    maxStatuses?: number;
+    /**
+     * Minimum account age in whole days.
+     */
+    minAccountAgeDays?: number;
+    /**
+     * Minimum follower count. Filtering happens before billing.
+     */
+    minFollowers?: number;
+    /**
+     * Profiles must follow at least this many accounts.
+     */
+    minFollowing?: number;
+    /**
+     * Minimum post count. minPosts is also accepted.
+     */
+    minStatuses?: number;
+    /**
+     * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
+     * Coverage returns diagnostics once and rejects cursors.
+     */
+    mode?: 'standard' | 'coverage';
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Up to 300 user profiles in automatic mode, 200 in standard. Sources can return
+     * fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results,
+     * maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+    /**
+     * Match a username substring, ignoring case.
+     */
+    usernameContains?: string;
+    /**
+     * Only return verified profiles.
+     */
+    verifiedOnly?: boolean;
+    /**
+     * Match the verification type exactly, ignoring case.
+     */
+    verifiedType?: string;
+}
+export interface UserRetrieveFollowingIDsParams {
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * User IDs to request from this page (1-5000, default 5000). Credits can return
+     * fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results,
+     * maxItems, max_items & per_page.
+     */
+    pageSize?: number;
+}
+export interface UserRetrieveHighlightsParams {
+    /**
+     * Words or quoted phrases where any one can match. Separate with spaces, commas,
+     * or lines.
+     */
+    anyWords?: string;
+    /**
+     * Only return tweets from Blue-verified authors.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Cashtags separated by spaces, commas, or lines.
+     */
+    cashtags?: string;
+    /**
+     * Conversation ID filter.
+     */
+    conversationId?: string;
+    /**
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
+     */
+    cursor?: string;
+    /**
+     * Match this literal phrase, including any hyphens.
+     */
+    exactPhrase?: string;
+    /**
+     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+     */
+    excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Filter by author username.
+     */
+    fromUser?: string;
+    /**
+     * Hashtags separated by spaces, commas, or lines.
+     */
+    hashtags?: string;
+    /**
+     * Only replies to this tweet ID.
+     */
+    inReplyToTweetId?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
+     */
+    language?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
+     */
+    maxFaves?: number;
+    /**
+     * Return Tweets at or below this ID.
+     */
+    maxId?: string;
+    /**
+     * Maximum quotes threshold.
+     */
+    maxQuotes?: number;
+    /**
+     * Maximum replies threshold.
+     */
+    maxReplies?: number;
+    /**
+     * Maximum retweets threshold.
+     */
+    maxRetweets?: number;
+    /**
+     * Filter media. Aliases: has_video, has_media.
+     */
+    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    /**
+     * Filter tweets mentioning a username.
+     */
+    mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
      */
-    bioContains?: string;
+    minLikes?: number;
     /**
-     * Cursor from the previous response. Xquik cursors resume automatic coverage.
-     * Existing unprefixed cursors keep legacy standard behavior.
+     * Minimum quote count threshold.
      */
-    cursor?: string;
+    minQuotes?: number;
     /**
-     * Only return profiles with a location.
+     * Minimum replies threshold.
      */
-    hasLocation?: boolean;
+    minReplies?: number;
     /**
-     * Only return profiles with a website.
+     * Minimum retweets threshold.
      */
-    hasWebsite?: boolean;
+    minRetweets?: number;
     /**
-     * Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
-     * Prefer pageSize.
+     * Minimum view count threshold.
      */
-    limit?: number;
+    minViews?: number;
     /**
-     * Match a location substring, ignoring case.
+     * Only return native reposts.
      */
-    locationContains?: string;
+    nativeRetweets?: boolean;
     /**
-     * Maximum follower count. Missing counts pass this maximum.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
      */
-    maxFollowers?: number;
+    omit?: string;
     /**
-     * Maximum following count.
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
-    maxFollowing?: number;
+    pageSize?: number;
     /**
-     * Maximum post count. maxPosts is also accepted.
+     * Only when the caller requests a quote mode.
      */
-    maxStatuses?: number;
+    quotes?: 'include' | 'exclude' | 'only';
     /**
-     * Minimum account age in whole days.
+     * Only quotes of this tweet ID.
      */
-    minAccountAgeDays?: number;
+    quotesOfTweetId?: string;
     /**
-     * Minimum follower count. Filtering happens before billing.
+     * Reply mode. Exclude keeps own-thread replies.
      */
-    minFollowers?: number;
+    replies?: 'include' | 'exclude' | 'only';
     /**
-     * Minimum following count.
+     * Only when the caller requests a repost mode.
      */
-    minFollowing?: number;
+    retweets?: 'include' | 'exclude' | 'only';
     /**
-     * Minimum post count. minPosts is also accepted.
+     * Only retweets of this tweet ID.
      */
-    minStatuses?: number;
+    retweetsOfTweetId?: string;
     /**
-     * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
-     * Coverage returns diagnostics once and rejects cursors.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
-    mode?: 'standard' | 'coverage';
+    sinceDate?: string;
     /**
-     * Maximum user profiles: automatic 300; standard 200. Sources return fewer
-     * profiles. Continue with has_next_page.
+     * Return Tweets whose IDs exceed this ID.
      */
-    pageSize?: number;
+    sinceId?: string;
     /**
-     * Match a username substring, ignoring case.
+     * Filter replies sent to a username.
      */
-    usernameContains?: string;
+    toUser?: string;
     /**
-     * Only return verified profiles.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
+     */
+    untilDate?: string;
+    /**
+     * URL substring or domain filter.
+     */
+    url?: string;
+    /**
+     * Only return tweets from verified authors.
      */
     verifiedOnly?: boolean;
     /**
-     * Match the verification type exactly, ignoring case.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
-    verifiedType?: string;
+    withinTime?: string;
 }
-export interface UserRetrieveFollowersYouKnowParams {
+export interface UserRetrieveInsightsParams {
     /**
-     * Match any comma-separated or line-separated bio term, ignoring case.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    bioContains?: string;
+    fields?: string;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+}
+export interface UserRetrieveLikesParams {
+    /**
+     * Words or quoted phrases where any one can match. Separate with spaces, commas,
+     * or lines.
+     */
+    anyWords?: string;
+    /**
+     * Only return tweets from Blue-verified authors.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * @deprecated This endpoint no longer documents this filter. Remove it.
+     */
+    cardName?: string;
+    /**
+     * Cashtags separated by spaces, commas, or lines.
+     */
+    cashtags?: string;
+    /**
+     * Conversation ID filter.
+     */
+    conversationId?: string;
     /**
-     * Pagination cursor for followers-you-know
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Only return profiles with a location.
+     * Match this literal phrase, including any hyphens.
      */
-    hasLocation?: boolean;
+    exactPhrase?: string;
     /**
-     * Only return profiles with a website.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
-    hasWebsite?: boolean;
+    excludeSource?: string;
     /**
-     * Match a location substring, ignoring case.
+     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
-    locationContains?: string;
+    excludeWords?: string;
     /**
-     * Maximum follower count. Missing counts pass this maximum.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    maxFollowers?: number;
+    fields?: string;
     /**
-     * Maximum following count.
+     * Filter by author username.
      */
-    maxFollowing?: number;
+    fromUser?: string;
     /**
-     * Maximum post count. maxPosts is also accepted.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
-    maxStatuses?: number;
+    geocode?: string;
     /**
-     * Minimum account age in whole days.
+     * Hashtags separated by spaces, commas, or lines.
      */
-    minAccountAgeDays?: number;
+    hashtags?: string;
     /**
-     * Minimum follower count. Filtering happens before billing.
+     * Only replies to this tweet ID.
      */
-    minFollowers?: number;
+    inReplyToTweetId?: string;
     /**
-     * Minimum following count.
+     * Filter by language. Alias `lang` is accepted.
      */
-    minFollowing?: number;
+    language?: string;
     /**
-     * Minimum post count. minPosts is also accepted.
+     * Maximum likes threshold. maxLikes & max_likes also work.
      */
-    minStatuses?: number;
+    maxFaves?: number;
+    /**
+     * Return Tweets at or below this ID.
+     */
+    maxId?: string;
+    /**
+     * Maximum quotes threshold.
+     */
+    maxQuotes?: number;
     /**
-     * Maximum user profiles requested from this page (20-200, default 200). Source,
-     * filters, or credits can return fewer profiles. Keep requesting next_cursor while
-     * has_next_page is true. Deprecated aliases remain accepted.
+     * Maximum replies threshold.
+     */
+    maxReplies?: number;
+    /**
+     * Maximum retweets threshold.
+     */
+    maxRetweets?: number;
+    /**
+     * Filter media. Aliases: has_video, has_media.
+     */
+    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    /**
+     * Filter tweets mentioning a username.
+     */
+    mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
+    /**
+     * @deprecated Use minLikes instead. The API still reads minFaves.
+     */
+    minFaves?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
+    /**
+     * Minimum quote count threshold.
+     */
+    minQuotes?: number;
+    /**
+     * Minimum replies threshold.
+     */
+    minReplies?: number;
+    /**
+     * Minimum retweets threshold.
+     */
+    minRetweets?: number;
+    /**
+     * Minimum view count threshold.
+     */
+    minViews?: number;
+    /**
+     * Only return native reposts.
+     */
+    nativeRetweets?: boolean;
+    /**
+     * @deprecated This endpoint no longer documents this filter. Remove it.
+     */
+    near?: string;
+    /**
+     * @deprecated This endpoint no longer documents this filter. Remove it.
+     */
+    news?: boolean;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Match a username substring, ignoring case.
+     * Only when the caller requests a quote mode.
      */
-    usernameContains?: string;
+    quotes?: 'include' | 'exclude' | 'only';
     /**
-     * Only return verified profiles.
+     * Only quotes of this tweet ID.
      */
-    verifiedOnly?: boolean;
+    quotesOfTweetId?: string;
     /**
-     * Match the verification type exactly, ignoring case.
+     * Reply mode. Exclude keeps own-thread replies.
      */
-    verifiedType?: string;
-}
-export interface UserRetrieveFollowingParams {
+    replies?: 'include' | 'exclude' | 'only';
     /**
-     * Deprecated following cursor alias. Prefer cursor.
+     * Only when the caller requests a repost mode.
      */
-    after?: string;
+    retweets?: 'include' | 'exclude' | 'only';
     /**
-     * Match any comma-separated or line-separated bio term, ignoring case.
+     * Only retweets of this tweet ID.
      */
-    bioContains?: string;
+    retweetsOfTweetId?: string;
     /**
-     * Cursor from the previous response. Xquik cursors resume automatic coverage.
-     * Existing unprefixed cursors keep legacy standard behavior.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
-    cursor?: string;
+    safe?: boolean;
     /**
-     * Only return profiles with a location.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
-    hasLocation?: boolean;
+    sinceDate?: string;
     /**
-     * Only return profiles with a website.
+     * Return Tweets whose IDs exceed this ID.
      */
-    hasWebsite?: boolean;
+    sinceId?: string;
     /**
-     * Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
-     * Prefer pageSize.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
-    limit?: number;
+    source?: string;
     /**
-     * Match a location substring, ignoring case.
+     * Filter replies sent to a username.
      */
-    locationContains?: string;
+    toUser?: string;
     /**
-     * Maximum follower count. Missing counts pass this maximum.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
      */
-    maxFollowers?: number;
+    untilDate?: string;
     /**
-     * Maximum following count.
+     * URL substring or domain filter.
      */
-    maxFollowing?: number;
+    url?: string;
     /**
-     * Maximum post count. maxPosts is also accepted.
+     * Only return tweets from verified authors.
      */
-    maxStatuses?: number;
+    verifiedOnly?: boolean;
     /**
-     * Minimum account age in whole days.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
-    minAccountAgeDays?: number;
+    within?: string;
     /**
-     * Minimum follower count. Filtering happens before billing.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
-    minFollowers?: number;
+    withinTime?: string;
+}
+export interface UserRetrieveListMembershipsParams {
     /**
-     * Minimum following count.
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
-    minFollowing?: number;
+    cursor?: string;
     /**
-     * Minimum post count. minPosts is also accepted.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    minStatuses?: number;
+    fields?: string;
     /**
-     * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
-     * Coverage returns diagnostics once and rejects cursors.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
      */
-    mode?: 'standard' | 'coverage';
+    omit?: string;
     /**
-     * Maximum user profiles: automatic 300; standard 200. Sources return fewer
-     * profiles. Continue with has_next_page.
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
+}
+export interface UserRetrieveListsParams {
     /**
-     * Match a username substring, ignoring case.
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
-    usernameContains?: string;
+    cursor?: string;
     /**
-     * Only return verified profiles.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    verifiedOnly?: boolean;
+    fields?: string;
     /**
-     * Match the verification type exactly, ignoring case.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
      */
-    verifiedType?: string;
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
+     */
+    pageSize?: number;
 }
-export interface UserRetrieveLikesParams {
+export interface UserRetrieveLiveParams {
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+}
+export interface UserRetrieveMediaParams {
     /**
      * Words or quoted phrases where any one can match. Separate with spaces, commas,
      * or lines.
@@ -803,7 +3106,7 @@ export interface UserRetrieveLikesParams {
      */
     blueVerifiedOnly?: boolean;
     /**
-     * Match the Tweet card name.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     cardName?: string;
     /**
@@ -815,27 +3118,37 @@ export interface UserRetrieveLikesParams {
      */
     conversationId?: string;
     /**
-     * Pagination cursor for liked tweets
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Exact phrase to match.
+     * Match this literal phrase, including any hyphens.
      */
     exactPhrase?: string;
     /**
-     * Exclude a source application.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
     excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
     /**
      * Filter by author username.
      */
     fromUser?: string;
     /**
-     * Match latitude, longitude, and radius.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     geocode?: string;
     /**
@@ -847,15 +3160,15 @@ export interface UserRetrieveLikesParams {
      */
     inReplyToTweetId?: string;
     /**
-     * Language code filter, e.g. en or tr.
+     * Filter by language. Alias `lang` is accepted.
      */
     language?: string;
     /**
-     * Maximum likes threshold. maxLikes is also accepted.
+     * Maximum likes threshold. maxLikes & max_likes also work.
      */
     maxFaves?: number;
     /**
-     * Return Tweets older than this Tweet ID.
+     * Return Tweets at or below this ID.
      */
     maxId?: string;
     /**
@@ -871,7 +3184,7 @@ export interface UserRetrieveLikesParams {
      */
     maxRetweets?: number;
     /**
-     * Filter by media type.
+     * Filter media. Aliases: has_video, has_media.
      */
     mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
     /**
@@ -883,9 +3196,13 @@ export interface UserRetrieveLikesParams {
      */
     minBookmarks?: number;
     /**
-     * Minimum likes threshold. minLikes is also accepted.
+     * @deprecated Use minLikes instead. The API still reads minFaves.
      */
     minFaves?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
     /**
      * Minimum quote count threshold.
      */
@@ -907,21 +3224,26 @@ export interface UserRetrieveLikesParams {
      */
     nativeRetweets?: boolean;
     /**
-     * Match a place name.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     near?: string;
     /**
-     * Only return news results.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     news?: boolean;
     /**
-     * Maximum page items (1-100, default 20). Source, filters, or credits can reduce
-     * results. Continue while has_next_page is true. Deprecated limit and count
-     * aliases remain accepted.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Quote mode.
+     * Only when the caller requests a quote mode.
      */
     quotes?: 'include' | 'exclude' | 'only';
     /**
@@ -929,11 +3251,11 @@ export interface UserRetrieveLikesParams {
      */
     quotesOfTweetId?: string;
     /**
-     * Reply mode.
+     * Reply mode. Exclude keeps own-thread replies.
      */
     replies?: 'include' | 'exclude' | 'only';
     /**
-     * Retweet mode.
+     * Only when the caller requests a repost mode.
      */
     retweets?: 'include' | 'exclude' | 'only';
     /**
@@ -941,19 +3263,19 @@ export interface UserRetrieveLikesParams {
      */
     retweetsOfTweetId?: string;
     /**
-     * Enable the safe-search filter.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     safe?: boolean;
     /**
-     * Start date in YYYY-MM-DD format.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
     sinceDate?: string;
     /**
-     * Return Tweets newer than this Tweet ID.
+     * Return Tweets whose IDs exceed this ID.
      */
     sinceId?: string;
     /**
-     * Match the source application.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     source?: string;
     /**
@@ -961,7 +3283,7 @@ export interface UserRetrieveLikesParams {
      */
     toUser?: string;
     /**
-     * End date in YYYY-MM-DD format.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
      */
     untilDate?: string;
     /**
@@ -973,15 +3295,16 @@ export interface UserRetrieveLikesParams {
      */
     verifiedOnly?: boolean;
     /**
-     * Set the radius for the near filter.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     within?: string;
     /**
-     * Match Tweets inside a recent time window.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
     withinTime?: string;
 }
-export interface UserRetrieveMediaParams {
+export interface UserRetrieveMentionsParams {
     /**
      * Words or quoted phrases where any one can match. Separate with spaces, commas,
      * or lines.
@@ -992,7 +3315,7 @@ export interface UserRetrieveMediaParams {
      */
     blueVerifiedOnly?: boolean;
     /**
-     * Match the Tweet card name.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     cardName?: string;
     /**
@@ -1004,27 +3327,37 @@ export interface UserRetrieveMediaParams {
      */
     conversationId?: string;
     /**
-     * Pagination cursor for media tweets
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Exact phrase to match.
+     * Match this literal phrase, including any hyphens.
      */
     exactPhrase?: string;
     /**
-     * Exclude a source application.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
     excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
     /**
      * Filter by author username.
      */
     fromUser?: string;
     /**
-     * Match latitude, longitude, and radius.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     geocode?: string;
     /**
@@ -1036,15 +3369,15 @@ export interface UserRetrieveMediaParams {
      */
     inReplyToTweetId?: string;
     /**
-     * Language code filter, e.g. en or tr.
+     * Filter by language. Alias `lang` is accepted.
      */
     language?: string;
     /**
-     * Maximum likes threshold. maxLikes is also accepted.
+     * Maximum likes threshold. maxLikes & max_likes also work.
      */
     maxFaves?: number;
     /**
-     * Return Tweets older than this Tweet ID.
+     * Return Tweets at or below this ID.
      */
     maxId?: string;
     /**
@@ -1060,7 +3393,7 @@ export interface UserRetrieveMediaParams {
      */
     maxRetweets?: number;
     /**
-     * Filter by media type.
+     * Filter media. Aliases: has_video, has_media.
      */
     mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
     /**
@@ -1072,9 +3405,13 @@ export interface UserRetrieveMediaParams {
      */
     minBookmarks?: number;
     /**
-     * Minimum likes threshold. minLikes is also accepted.
+     * @deprecated Use minLikes instead. The API still reads minFaves.
      */
     minFaves?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
     /**
      * Minimum quote count threshold.
      */
@@ -1096,21 +3433,26 @@ export interface UserRetrieveMediaParams {
      */
     nativeRetweets?: boolean;
     /**
-     * Match a place name.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     near?: string;
     /**
-     * Only return news results.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     news?: boolean;
     /**
-     * Maximum page items (1-100, default 20). Source, filters, or credits can reduce
-     * results. Continue while has_next_page is true. Deprecated limit and count
-     * aliases remain accepted.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Quote mode.
+     * Only when the caller requests a quote mode.
      */
     quotes?: 'include' | 'exclude' | 'only';
     /**
@@ -1118,11 +3460,11 @@ export interface UserRetrieveMediaParams {
      */
     quotesOfTweetId?: string;
     /**
-     * Reply mode.
+     * Reply mode. Exclude keeps own-thread replies.
      */
     replies?: 'include' | 'exclude' | 'only';
     /**
-     * Retweet mode.
+     * Only when the caller requests a repost mode.
      */
     retweets?: 'include' | 'exclude' | 'only';
     /**
@@ -1130,19 +3472,24 @@ export interface UserRetrieveMediaParams {
      */
     retweetsOfTweetId?: string;
     /**
-     * Enable the safe-search filter.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     safe?: boolean;
     /**
-     * Start date in YYYY-MM-DD format.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
     sinceDate?: string;
     /**
-     * Return Tweets newer than this Tweet ID.
+     * Return Tweets whose IDs exceed this ID.
      */
     sinceId?: string;
     /**
-     * Match the source application.
+     * Inclusive ISO bound for Tweet creation time, such as 2026-09-25T19:20:41Z. Unix
+     * seconds also work. A time without an offset is UTC.
+     */
+    sinceTime?: string;
+    /**
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     source?: string;
     /**
@@ -1150,9 +3497,14 @@ export interface UserRetrieveMediaParams {
      */
     toUser?: string;
     /**
-     * End date in YYYY-MM-DD format.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
      */
     untilDate?: string;
+    /**
+     * Exclusive ISO bound for Tweet creation time. Unix seconds also work. A time
+     * without an offset is UTC.
+     */
+    untilTime?: string;
     /**
      * URL substring or domain filter.
      */
@@ -1162,15 +3514,20 @@ export interface UserRetrieveMediaParams {
      */
     verifiedOnly?: boolean;
     /**
-     * Set the radius for the near filter.
+     * @deprecated This endpoint no longer documents this filter. Remove it.
      */
     within?: string;
     /**
-     * Match Tweets inside a recent time window.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
     withinTime?: string;
 }
-export interface UserRetrieveMentionsParams {
+export interface UserRetrieveRepliesParams {
+    /**
+     * Raw advanced search query appended as-is.
+     */
+    advancedQuery?: string;
     /**
      * Words or quoted phrases where any one can match. Separate with spaces, commas,
      * or lines.
@@ -1181,7 +3538,12 @@ export interface UserRetrieveMentionsParams {
      */
     blueVerifiedOnly?: boolean;
     /**
-     * Match the Tweet card name.
+     * Geo bounding box, e.g. -74.1 40.6 -73.9 40.8.
+     */
+    boundingBox?: string;
+    /**
+     * Keep only Tweets with this card type, such as poll2choice_text_only. Tweet
+     * search checks each Tweet's card.
      */
     cardName?: string;
     /**
@@ -1193,47 +3555,74 @@ export interface UserRetrieveMentionsParams {
      */
     conversationId?: string;
     /**
-     * Pagination cursor for mentions
+     * Cursor from the previous response. Existing unprefixed cursors keep legacy
+     * standard behavior. Pages can be empty before more rows; follow next_cursor. Also
+     * read as next_cursor, next_token, pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Exact phrase to match.
+     * Match this literal phrase, including any hyphens.
      */
     exactPhrase?: string;
     /**
-     * Exclude a source application.
+     * X search no longer supports excludeSource. A Tweet search with it answers 424 &
+     * charges nothing.
      */
     excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
     excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
     /**
      * Filter by author username.
      */
     fromUser?: string;
     /**
-     * Match latitude, longitude, and radius.
+     * X search no longer supports geocode. A Tweet search with it answers 424 &
+     * charges nothing.
      */
     geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
     hashtags?: string;
+    /**
+     * Include each reply's parent tweet as parentTweet on the reply. A reply whose
+     * parent X does not return comes without it. Search-only filters such as keywords
+     * do not apply with it.
+     */
+    includeParentTweet?: boolean;
     /**
      * Only replies to this tweet ID.
      */
     inReplyToTweetId?: string;
     /**
-     * Language code filter, e.g. en or tr.
+     * Words the Tweets must match, in X search syntax.
+     */
+    keywords?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
      */
     language?: string;
     /**
-     * Maximum likes threshold. maxLikes is also accepted.
+     * Search within a list ID.
+     */
+    listId?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
      */
     maxFaves?: number;
     /**
-     * Return Tweets older than this Tweet ID.
+     * Return Tweets at or below this ID.
      */
     maxId?: string;
     /**
@@ -1249,7 +3638,7 @@ export interface UserRetrieveMentionsParams {
      */
     maxRetweets?: number;
     /**
-     * Filter by media type.
+     * Filter media. Aliases: has_video, has_media.
      */
     mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
     /**
@@ -1261,9 +3650,13 @@ export interface UserRetrieveMentionsParams {
      */
     minBookmarks?: number;
     /**
-     * Minimum likes threshold. minLikes is also accepted.
+     * @deprecated Use minLikes instead. The API still reads minFaves.
      */
     minFaves?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
     /**
      * Minimum quote count threshold.
      */
@@ -1280,6 +3673,11 @@ export interface UserRetrieveMentionsParams {
      * Minimum view count threshold.
      */
     minViews?: number;
+    /**
+     * Optional legacy pagination override. Search-only filters such as keywords apply
+     * only without it.
+     */
+    mode?: 'standard';
     /**
      * Only return native reposts.
      */
@@ -1289,17 +3687,34 @@ export interface UserRetrieveMentionsParams {
      */
     near?: string;
     /**
-     * Only return news results.
+     * X no longer searches filter:news.
      */
     news?: boolean;
     /**
-     * Maximum page items (1-100, default 20). Source, filters, or credits can reduce
-     * results. Continue while has_next_page is true. Deprecated limit and count
-     * aliases remain accepted.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Automatic pages accept 1-300 Tweets, standard pages 1-100. Default 20. Follow
+     * next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Quote mode.
+     * Search within a place ID.
+     */
+    place?: string;
+    /**
+     * Search within a country code.
+     */
+    placeCountry?: string;
+    /**
+     * Geo point radius, e.g. -73.99 40.73 25mi.
+     */
+    pointRadius?: string;
+    /**
+     * Only when the caller requests a quote mode.
      */
     quotes?: 'include' | 'exclude' | 'only';
     /**
@@ -1307,11 +3722,11 @@ export interface UserRetrieveMentionsParams {
      */
     quotesOfTweetId?: string;
     /**
-     * Reply mode.
+     * Reply mode. Exclude keeps own-thread replies.
      */
     replies?: 'include' | 'exclude' | 'only';
     /**
-     * Retweet mode.
+     * Only when the caller requests a repost mode.
      */
     retweets?: 'include' | 'exclude' | 'only';
     /**
@@ -1323,19 +3738,21 @@ export interface UserRetrieveMentionsParams {
      */
     safe?: boolean;
     /**
-     * Start date in YYYY-MM-DD format.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
     sinceDate?: string;
     /**
-     * Return Tweets newer than this Tweet ID.
+     * Return Tweets whose IDs exceed this ID.
      */
     sinceId?: string;
     /**
-     * Unix timestamp - return mentions after this time
+     * Inclusive ISO bound for Tweet creation time, such as 2026-09-25T19:20:41Z. Unix
+     * seconds also work. A time without an offset is UTC.
      */
     sinceTime?: string;
     /**
-     * Match the source application.
+     * X search no longer supports source. A Tweet search with it answers 424 & charges
+     * nothing.
      */
     source?: string;
     /**
@@ -1343,11 +3760,12 @@ export interface UserRetrieveMentionsParams {
      */
     toUser?: string;
     /**
-     * End date in YYYY-MM-DD format.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
      */
     untilDate?: string;
     /**
-     * Unix timestamp - return mentions before this time
+     * Exclusive ISO bound for Tweet creation time. Unix seconds also work. A time
+     * without an offset is UTC.
      */
     untilTime?: string;
     /**
@@ -1359,220 +3777,264 @@ export interface UserRetrieveMentionsParams {
      */
     verifiedOnly?: boolean;
     /**
-     * Set the radius for the near filter.
+     * X search no longer supports within. A Tweet search with it answers 424 & charges
+     * nothing. Use near alone.
      */
     within?: string;
     /**
-     * Match Tweets inside a recent time window.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
     withinTime?: string;
 }
-export interface UserRetrieveRepliesParams {
+export interface UserRetrieveSearchParams {
     /**
-     * Words or quoted phrases where any one can match. Separate with spaces, commas,
-     * or lines.
+     * User search query
      */
-    anyWords?: string;
+    q: string;
     /**
-     * Only return tweets from Blue-verified authors.
+     * Match any comma-separated or line-separated bio term, ignoring case.
      */
-    blueVerifiedOnly?: boolean;
+    bioContains?: string;
     /**
-     * Match the Tweet card name.
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
      */
-    cardName?: string;
+    blueVerifiedOnly?: boolean;
     /**
-     * Cashtags separated by spaces, commas, or lines.
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
      */
-    cashtags?: string;
+    businessEmailOnly?: boolean;
     /**
-     * Conversation ID filter.
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
-    conversationId?: string;
+    cursor?: string;
     /**
-     * Cursor from the previous response. Xquik cursors resume automatic coverage.
-     * Existing unprefixed cursors keep legacy standard behavior.
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
      */
-    cursor?: string;
+    emailDomains?: string;
     /**
-     * Exact phrase to match.
+     * Add each row's full profile, as GET /x/users/{id} returns it. Pages take several
+     * seconds longer.
      */
-    exactPhrase?: string;
+    enrichProfiles?: boolean;
     /**
-     * Exclude a source application.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    excludeSource?: string;
+    fields?: string;
     /**
-     * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+     * Only return profiles that publish an email.
      */
-    excludeWords?: string;
+    hasEmail?: boolean;
     /**
-     * Filter by author username.
+     * Only return profiles with a location.
      */
-    fromUser?: string;
+    hasLocation?: boolean;
     /**
-     * Match latitude, longitude, and radius.
+     * Only return profiles with a website.
      */
-    geocode?: string;
+    hasWebsite?: boolean;
     /**
-     * Hashtags separated by spaces, commas, or lines.
+     * Match a location substring, ignoring case.
      */
-    hashtags?: string;
+    locationContains?: string;
     /**
-     * Include each reply's parent tweet.
+     * Maximum follower count. Missing counts pass this maximum.
      */
-    includeParentTweet?: boolean;
+    maxFollowers?: number;
     /**
-     * Only replies to this tweet ID.
+     * Profiles may follow at most this many accounts.
      */
-    inReplyToTweetId?: string;
+    maxFollowing?: number;
     /**
-     * Language code filter, e.g. en or tr.
+     * Maximum post count. maxPosts is also accepted.
      */
-    language?: string;
+    maxStatuses?: number;
     /**
-     * Maximum likes threshold. maxLikes is also accepted.
+     * Minimum account age in whole days.
      */
-    maxFaves?: number;
+    minAccountAgeDays?: number;
     /**
-     * Return Tweets older than this Tweet ID.
+     * Minimum follower count. Filtering happens before billing.
      */
-    maxId?: string;
+    minFollowers?: number;
     /**
-     * Maximum quotes threshold.
+     * Profiles must follow at least this many accounts.
      */
-    maxQuotes?: number;
+    minFollowing?: number;
     /**
-     * Maximum replies threshold.
+     * Minimum post count. minPosts is also accepted.
      */
-    maxReplies?: number;
+    minStatuses?: number;
     /**
-     * Maximum retweets threshold.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
      */
-    maxRetweets?: number;
+    omit?: string;
     /**
-     * Filter by media type.
+     * Items per page (1-100, default 20). Source, filters or credits can return fewer.
+     * Follow next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
-    mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+    pageSize?: number;
     /**
-     * Filter tweets mentioning a username.
+     * Match a username substring, ignoring case.
      */
-    mentioning?: string;
+    usernameContains?: string;
     /**
-     * Minimum bookmark count threshold.
+     * Only return verified profiles.
      */
-    minBookmarks?: number;
+    verifiedOnly?: boolean;
     /**
-     * Minimum likes threshold. minLikes is also accepted.
+     * Match the verification type exactly, ignoring case.
      */
-    minFaves?: number;
+    verifiedType?: string;
+}
+export interface UserRetrieveSimilarParams {
     /**
-     * Minimum quote count threshold.
+     * Match any comma-separated or line-separated bio term, ignoring case.
      */
-    minQuotes?: number;
+    bioContains?: string;
     /**
-     * Minimum replies threshold.
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
      */
-    minReplies?: number;
+    blueVerifiedOnly?: boolean;
     /**
-     * Minimum retweets threshold.
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
      */
-    minRetweets?: number;
+    businessEmailOnly?: boolean;
     /**
-     * Minimum view count threshold.
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
-    minViews?: number;
+    cursor?: string;
     /**
-     * Only return native reposts.
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
      */
-    nativeRetweets?: boolean;
+    emailDomains?: string;
     /**
-     * Match a place name.
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
      */
-    near?: string;
+    fields?: string;
     /**
-     * Only return news results.
+     * Only return profiles that publish an email.
      */
-    news?: boolean;
+    hasEmail?: boolean;
     /**
-     * Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20.
-     * Continue while has_next_page is true. Deprecated aliases remain accepted.
+     * Only return profiles with a location.
      */
-    pageSize?: number;
+    hasLocation?: boolean;
     /**
-     * Quote mode.
+     * Only return profiles with a website.
      */
-    quotes?: 'include' | 'exclude' | 'only';
+    hasWebsite?: boolean;
     /**
-     * Only quotes of this tweet ID.
+     * Match a location substring, ignoring case.
      */
-    quotesOfTweetId?: string;
+    locationContains?: string;
     /**
-     * Reply mode.
+     * Maximum follower count. Missing counts pass this maximum.
      */
-    replies?: 'include' | 'exclude' | 'only';
+    maxFollowers?: number;
     /**
-     * Retweet mode.
+     * Profiles may follow at most this many accounts.
      */
-    retweets?: 'include' | 'exclude' | 'only';
+    maxFollowing?: number;
     /**
-     * Only retweets of this tweet ID.
+     * Maximum post count. maxPosts is also accepted.
      */
-    retweetsOfTweetId?: string;
+    maxStatuses?: number;
     /**
-     * Enable the safe-search filter.
+     * Minimum account age in whole days.
      */
-    safe?: boolean;
+    minAccountAgeDays?: number;
     /**
-     * Start date in YYYY-MM-DD format.
+     * Minimum follower count. Filtering happens before billing.
      */
-    sinceDate?: string;
+    minFollowers?: number;
     /**
-     * Return Tweets newer than this Tweet ID.
+     * Profiles must follow at least this many accounts.
      */
-    sinceId?: string;
+    minFollowing?: number;
     /**
-     * Match the source application.
+     * Minimum post count. minPosts is also accepted.
      */
-    source?: string;
+    minStatuses?: number;
     /**
-     * Filter replies sent to a username.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
      */
-    toUser?: string;
+    omit?: string;
     /**
-     * End date in YYYY-MM-DD format.
+     * Profiles to request from this page (1-200, default 200). Source, filters or
+     * credits can return fewer. Follow next_cursor for more pages. Aliases: limit,
+     * count, max_results, maxItems, max_items & per_page.
      */
-    untilDate?: string;
+    pageSize?: number;
     /**
-     * URL substring or domain filter.
+     * Match a username substring, ignoring case.
      */
-    url?: string;
+    usernameContains?: string;
     /**
-     * Only return tweets from verified authors.
+     * Only return verified profiles.
      */
     verifiedOnly?: boolean;
     /**
-     * Set the radius for the near filter.
+     * Match the verification type exactly, ignoring case.
      */
-    within?: string;
+    verifiedType?: string;
+}
+export interface UserRetrieveSubscriptionsParams {
     /**
-     * Match Tweets inside a recent time window.
+     * Match any comma-separated or line-separated bio term, ignoring case.
      */
-    withinTime?: string;
-}
-export interface UserRetrieveSearchParams {
+    bioContains?: string;
     /**
-     * User search query
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
      */
-    q: string;
+    blueVerifiedOnly?: boolean;
     /**
-     * Match any comma-separated or line-separated bio term, ignoring case.
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
      */
-    bioContains?: string;
+    businessEmailOnly?: boolean;
     /**
-     * Pagination cursor for user search
+     * Pagination cursor for collection results. Also read as next_cursor, next_token,
+     * pagination_token or continuation_token.
      */
     cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
     /**
      * Only return profiles with a location.
      */
@@ -1590,7 +4052,7 @@ export interface UserRetrieveSearchParams {
      */
     maxFollowers?: number;
     /**
-     * Maximum following count.
+     * Profiles may follow at most this many accounts.
      */
     maxFollowing?: number;
     /**
@@ -1606,13 +4068,24 @@ export interface UserRetrieveSearchParams {
      */
     minFollowers?: number;
     /**
-     * Minimum following count.
+     * Profiles must follow at least this many accounts.
      */
     minFollowing?: number;
     /**
      * Minimum post count. minPosts is also accepted.
      */
     minStatuses?: number;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Profiles to request from this page (1-200, default 200). Source, filters or
+     * credits can return fewer. Follow next_cursor for more pages. Aliases: limit,
+     * count, max_results, maxItems, max_items & per_page.
+     */
+    pageSize?: number;
     /**
      * Match a username substring, ignoring case.
      */
@@ -1627,6 +4100,10 @@ export interface UserRetrieveSearchParams {
     verifiedType?: string;
 }
 export interface UserRetrieveTweetsParams {
+    /**
+     * Raw advanced search query appended as-is.
+     */
+    advancedQuery?: string;
     /**
      * Words or quoted phrases where any one can match. Separate with spaces, commas,
      * or lines.
@@ -1637,7 +4114,12 @@ export interface UserRetrieveTweetsParams {
      */
     blueVerifiedOnly?: boolean;
     /**
-     * Match the Tweet card name.
+     * Geo bounding box, e.g. -74.1 40.6 -73.9 40.8.
+     */
+    boundingBox?: string;
+    /**
+     * Keep only Tweets with this card type, such as poll2choice_text_only. Tweet
+     * search checks each Tweet's card.
      */
     cardName?: string;
     /**
@@ -1649,28 +4131,40 @@ export interface UserRetrieveTweetsParams {
      */
     conversationId?: string;
     /**
-     * Cursor from the previous response. Xquik cursors resume automatic coverage.
-     * Existing unprefixed cursors keep legacy standard behavior.
+     * Cursor from the previous response. Existing unprefixed cursors keep legacy
+     * standard behavior. Pages can be empty before more rows; follow next_cursor. Also
+     * read as next_cursor, next_token, pagination_token or continuation_token.
      */
     cursor?: string;
     /**
-     * Exact phrase to match.
+     * Match this literal phrase, including any hyphens.
      */
     exactPhrase?: string;
     /**
-     * Exclude a source application.
+     * X search no longer supports excludeSource. A Tweet search with it answers 424 &
+     * charges nothing.
      */
     excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
     excludeWords?: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
     /**
      * Filter by author username.
      */
     fromUser?: string;
     /**
-     * Match latitude, longitude, and radius.
+     * X search no longer supports geocode. A Tweet search with it answers 424 &
+     * charges nothing.
      */
     geocode?: string;
     /**
@@ -1678,11 +4172,13 @@ export interface UserRetrieveTweetsParams {
      */
     hashtags?: string;
     /**
-     * Include parent tweet for replies
+     * Include each reply's parent tweet as parentTweet on the reply. A reply whose
+     * parent X does not return comes without it. Search-only filters such as keywords
+     * do not apply with it.
      */
     includeParentTweet?: boolean;
     /**
-     * Include reply tweets
+     * Include reply tweets unless replies specifies another mode.
      */
     includeReplies?: boolean;
     /**
@@ -1690,15 +4186,23 @@ export interface UserRetrieveTweetsParams {
      */
     inReplyToTweetId?: string;
     /**
-     * Language code filter, e.g. en or tr.
+     * Words the Tweets must match, in X search syntax.
+     */
+    keywords?: string;
+    /**
+     * Filter by language. Alias `lang` is accepted.
      */
     language?: string;
     /**
-     * Maximum likes threshold. maxLikes is also accepted.
+     * Search within a list ID.
+     */
+    listId?: string;
+    /**
+     * Maximum likes threshold. maxLikes & max_likes also work.
      */
     maxFaves?: number;
     /**
-     * Return Tweets older than this Tweet ID.
+     * Return Tweets at or below this ID.
      */
     maxId?: string;
     /**
@@ -1714,7 +4218,7 @@ export interface UserRetrieveTweetsParams {
      */
     maxRetweets?: number;
     /**
-     * Filter by media type.
+     * Filter media. Aliases: has_video, has_media.
      */
     mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
     /**
@@ -1726,9 +4230,13 @@ export interface UserRetrieveTweetsParams {
      */
     minBookmarks?: number;
     /**
-     * Minimum likes threshold. minLikes is also accepted.
+     * @deprecated Use minLikes instead. The API still reads minFaves.
      */
     minFaves?: number;
+    /**
+     * Minimum likes. Aliases: minFaves, min_likes, min_faves.
+     */
+    minLikes?: number;
     /**
      * Minimum quote count threshold.
      */
@@ -1745,6 +4253,11 @@ export interface UserRetrieveTweetsParams {
      * Minimum view count threshold.
      */
     minViews?: number;
+    /**
+     * Optional legacy pagination override. Search-only filters such as keywords apply
+     * only without it.
+     */
+    mode?: 'standard';
     /**
      * Only return native reposts.
      */
@@ -1754,16 +4267,34 @@ export interface UserRetrieveTweetsParams {
      */
     near?: string;
     /**
-     * Only return news results.
+     * X no longer searches filter:news.
      */
     news?: boolean;
     /**
-     * Automatic pages accept 1-300 Tweets. Standard pages keep 1-100. Default 20.
-     * Continue while has_next_page is true. Deprecated aliases remain accepted.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Automatic pages accept 1-300 Tweets, standard pages 1-100. Default 20. Follow
+     * next_cursor for more pages. Aliases: limit, count, max_results, maxItems,
+     * max_items & per_page.
      */
     pageSize?: number;
     /**
-     * Quote mode.
+     * Search within a place ID.
+     */
+    place?: string;
+    /**
+     * Search within a country code.
+     */
+    placeCountry?: string;
+    /**
+     * Geo point radius, e.g. -73.99 40.73 25mi.
+     */
+    pointRadius?: string;
+    /**
+     * Only when the caller requests a quote mode.
      */
     quotes?: 'include' | 'exclude' | 'only';
     /**
@@ -1771,11 +4302,11 @@ export interface UserRetrieveTweetsParams {
      */
     quotesOfTweetId?: string;
     /**
-     * Reply mode.
+     * Reply mode. Exclude keeps own-thread replies.
      */
     replies?: 'include' | 'exclude' | 'only';
     /**
-     * Retweet mode.
+     * Only when the caller requests a repost mode.
      */
     retweets?: 'include' | 'exclude' | 'only';
     /**
@@ -1787,15 +4318,21 @@ export interface UserRetrieveTweetsParams {
      */
     safe?: boolean;
     /**
-     * Start date in YYYY-MM-DD format.
+     * Start date in YYYY-MM-DD format, as a UTC day.
      */
     sinceDate?: string;
     /**
-     * Return Tweets newer than this Tweet ID.
+     * Return Tweets whose IDs exceed this ID.
      */
     sinceId?: string;
     /**
-     * Match the source application.
+     * Inclusive ISO bound for Tweet creation time, such as 2026-09-25T19:20:41Z. Unix
+     * seconds also work. A time without an offset is UTC.
+     */
+    sinceTime?: string;
+    /**
+     * X search no longer supports source. A Tweet search with it answers 424 & charges
+     * nothing.
      */
     source?: string;
     /**
@@ -1803,9 +4340,14 @@ export interface UserRetrieveTweetsParams {
      */
     toUser?: string;
     /**
-     * End date in YYYY-MM-DD format.
+     * End date in YYYY-MM-DD format, as a UTC day, inclusive, so its own posts count.
      */
     untilDate?: string;
+    /**
+     * Exclusive ISO bound for Tweet creation time. Unix seconds also work. A time
+     * without an offset is UTC.
+     */
+    untilTime?: string;
     /**
      * URL substring or domain filter.
      */
@@ -1815,11 +4357,13 @@ export interface UserRetrieveTweetsParams {
      */
     verifiedOnly?: boolean;
     /**
-     * Set the radius for the near filter.
+     * X search no longer supports within. A Tweet search with it answers 424 & charges
+     * nothing. Use near alone.
      */
     within?: string;
     /**
-     * Match Tweets inside a recent time window.
+     * Keeps Tweets from a recent window, such as 90m or 7d. Use a whole number & s, m,
+     * h or d.
      */
     withinTime?: string;
 }
@@ -1833,10 +4377,43 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     bioContains?: string;
     /**
-     * Cursor from the previous response. Xquik cursors resume automatic coverage.
-     * Existing unprefixed cursors keep legacy standard behavior.
+     * Only return profiles X marks as blue verified. X marks many business &
+     * government accounts blue too. Use verifiedType for 1 badge type.
+     */
+    blueVerifiedOnly?: boolean;
+    /**
+     * Only return profiles that publish an email outside free webmail, such as Gmail.
+     */
+    businessEmailOnly?: boolean;
+    /**
+     * Cursor from the previous response. Existing unprefixed cursors keep legacy
+     * standard behavior. Pages can be empty before more rows; follow next_cursor. Also
+     * read as next_cursor, next_token, pagination_token or continuation_token.
      */
     cursor?: string;
+    /**
+     * Only return profiles with an email at one of these domains. Separate domains
+     * with commas. Subdomains match.
+     */
+    emailDomains?: string;
+    /**
+     * Add each row's full profile, as GET /x/users/{id} returns it. Pages take several
+     * seconds longer.
+     */
+    enrichProfiles?: boolean;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Only return profiles that publish an email.
+     */
+    hasEmail?: boolean;
     /**
      * Only return profiles with a location.
      */
@@ -1846,8 +4423,8 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     hasWebsite?: boolean;
     /**
-     * Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
-     * Prefer pageSize.
+     * Legacy page-size alias outside coverage mode. Coverage accepts 1-10000. Prefer
+     * pageSize.
      */
     limit?: number;
     /**
@@ -1859,9 +4436,16 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     maxFollowers?: number;
     /**
-     * Maximum following count.
+     * Profiles may follow at most this many accounts.
      */
     maxFollowing?: number;
+    /**
+     * Most profiles 1 request reads, kept or dropped by the filters. A filter that
+     * keeps few profiles reads up to 65 s a request without it. The request then
+     * answers the profiles it kept, the count it dropped & the cursor to read on. Each
+     * request of a cursor may send its own value. Automatic mode only.
+     */
+    maxScan?: number;
     /**
      * Maximum post count. maxPosts is also accepted.
      */
@@ -1875,7 +4459,7 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     minFollowers?: number;
     /**
-     * Minimum following count.
+     * Profiles must follow at least this many accounts.
      */
     minFollowing?: number;
     /**
@@ -1888,8 +4472,14 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     mode?: 'standard' | 'coverage';
     /**
-     * Maximum user profiles: automatic 300; standard 200. Sources return fewer
-     * profiles. Continue with has_next_page.
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+    /**
+     * Up to 300 user profiles in automatic mode, 200 in standard. Sources can return
+     * fewer. Follow next_cursor for more pages. Aliases: limit, count, max_results,
+     * maxItems, max_items & per_page.
      */
     pageSize?: number;
     /**
@@ -1905,8 +4495,29 @@ export interface UserRetrieveVerifiedFollowersParams {
      */
     verifiedType?: string;
 }
+export interface UserTranslateBioParams {
+    /**
+     * Language code to translate into, such as `es`, `tr`, `pt-br`, or `zh-tw`. Upper
+     * and lower case both work.
+     */
+    language: string;
+    /**
+     * Fields to keep in each row, comma-separated. Use dots for nested fields, such as
+     * author.username. A list keeps the field in each item. Case & underscores do not
+     * matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics
+     * always stay. An unknown name answers 400 unknown_field with the valid names,
+     * before any read. The price stays the same. SDK row types then hold only the
+     * named fields.
+     */
+    fields?: string;
+    /**
+     * Fields to drop from each row, comma-separated. It takes the same names as
+     * fields. With fields, it drops from the kept fields.
+     */
+    omit?: string;
+}
 export declare namespace Users {
-    export { type UserRemoveFollowerResponse as UserRemoveFollowerResponse, type UserRetrieveBatchResponse as UserRetrieveBatchResponse, type UserRetrieveFollowersResponse as UserRetrieveFollowersResponse, type UserRetrieveFollowingResponse as UserRetrieveFollowingResponse, type UserRetrieveVerifiedFollowersResponse as UserRetrieveVerifiedFollowersResponse, type UserRemoveFollowerParams as UserRemoveFollowerParams, type UserRetrieveBatchParams as UserRetrieveBatchParams, type UserRetrieveFollowersParams as UserRetrieveFollowersParams, type UserRetrieveFollowersYouKnowParams as UserRetrieveFollowersYouKnowParams, type UserRetrieveFollowingParams as UserRetrieveFollowingParams, type UserRetrieveLikesParams as UserRetrieveLikesParams, type UserRetrieveMediaParams as UserRetrieveMediaParams, type UserRetrieveMentionsParams as UserRetrieveMentionsParams, type UserRetrieveRepliesParams as UserRetrieveRepliesParams, type UserRetrieveSearchParams as UserRetrieveSearchParams, type UserRetrieveTweetsParams as UserRetrieveTweetsParams, type UserRetrieveVerifiedFollowersParams as UserRetrieveVerifiedFollowersParams, };
+    export { type UserRemoveFollowerResponse as UserRemoveFollowerResponse, type UserRetrieveBatchResponse as UserRetrieveBatchResponse, type UserRetrieveBatchTweetsResponse as UserRetrieveBatchTweetsResponse, type UserRetrieveFollowerIDsResponse as UserRetrieveFollowerIDsResponse, type UserRetrieveFollowersResponse as UserRetrieveFollowersResponse, type UserRetrieveFollowingResponse as UserRetrieveFollowingResponse, type UserRetrieveFollowingIDsResponse as UserRetrieveFollowingIDsResponse, type UserRetrieveInsightsResponse as UserRetrieveInsightsResponse, type UserRetrieveListMembershipsResponse as UserRetrieveListMembershipsResponse, type UserRetrieveListsResponse as UserRetrieveListsResponse, type UserRetrieveLiveResponse as UserRetrieveLiveResponse, type UserRetrieveVerifiedFollowersResponse as UserRetrieveVerifiedFollowersResponse, type UserTranslateBioResponse as UserTranslateBioResponse, type UserRetrieveParams as UserRetrieveParams, type UserRemoveFollowerParams as UserRemoveFollowerParams, type UserRetrieveAffiliatesParams as UserRetrieveAffiliatesParams, type UserRetrieveArticlesParams as UserRetrieveArticlesParams, type UserRetrieveBatchParams as UserRetrieveBatchParams, type UserRetrieveBatchTweetsParams as UserRetrieveBatchTweetsParams, type UserRetrieveFollowerIDsParams as UserRetrieveFollowerIDsParams, type UserRetrieveFollowersParams as UserRetrieveFollowersParams, type UserRetrieveFollowersYouKnowParams as UserRetrieveFollowersYouKnowParams, type UserRetrieveFollowingParams as UserRetrieveFollowingParams, type UserRetrieveFollowingIDsParams as UserRetrieveFollowingIDsParams, type UserRetrieveHighlightsParams as UserRetrieveHighlightsParams, type UserRetrieveInsightsParams as UserRetrieveInsightsParams, type UserRetrieveLikesParams as UserRetrieveLikesParams, type UserRetrieveListMembershipsParams as UserRetrieveListMembershipsParams, type UserRetrieveListsParams as UserRetrieveListsParams, type UserRetrieveLiveParams as UserRetrieveLiveParams, type UserRetrieveMediaParams as UserRetrieveMediaParams, type UserRetrieveMentionsParams as UserRetrieveMentionsParams, type UserRetrieveRepliesParams as UserRetrieveRepliesParams, type UserRetrieveSearchParams as UserRetrieveSearchParams, type UserRetrieveSimilarParams as UserRetrieveSimilarParams, type UserRetrieveSubscriptionsParams as UserRetrieveSubscriptionsParams, type UserRetrieveTweetsParams as UserRetrieveTweetsParams, type UserRetrieveVerifiedFollowersParams as UserRetrieveVerifiedFollowersParams, type UserTranslateBioParams as UserTranslateBioParams, };
     export { Follow as Follow, type FollowCreateResponse as FollowCreateResponse, type FollowDeleteAllResponse as FollowDeleteAllResponse, type FollowCreateParams as FollowCreateParams, type FollowDeleteAllParams as FollowDeleteAllParams, };
 }
 //# sourceMappingURL=users.d.ts.map