x-twitter-scraper 0.8.4 → 0.10.0

package/src/resources/x/users/users.ts

@@ -80,15 +80,16 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const paginatedUsers =
-   *   await client.x.users.retrieveFollowers('id');
+   * const response = await client.x.users.retrieveFollowers(
+   *   'id',
+   * );
    * ```
    */
   retrieveFollowers(
     id: string,
     query: UserRetrieveFollowersParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<Shared.PaginatedUsers> {
+  ): APIPromise<UserRetrieveFollowersResponse> {
     return this._client.get(path`/x/users/${id}/followers`, { query, ...options });
   }
 
@@ -114,15 +115,16 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const paginatedUsers =
-   *   await client.x.users.retrieveFollowing('id');
+   * const response = await client.x.users.retrieveFollowing(
+   *   'id',
+   * );
    * ```
    */
   retrieveFollowing(
     id: string,
     query: UserRetrieveFollowingParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<Shared.PaginatedUsers> {
+  ): APIPromise<UserRetrieveFollowingResponse> {
     return this._client.get(path`/x/users/${id}/following`, { query, ...options });
   }
 
@@ -180,7 +182,9 @@ export class Users extends APIResource {
   }
 
   /**
-   * Returns the user's timeline with replies included by default.
+   * Returns target-authored posts and replies. Omit mode for automatic maximum
+   * coverage. Pass next_cursor unchanged. Unprefixed cursors stay legacy. Excludes
+   * other-author context.
    *
    * @example
    * ```ts
@@ -214,7 +218,8 @@ export class Users extends APIResource {
   }
 
   /**
-   * List recent tweets posted by a user
+   * Omit mode for automatic maximum coverage. Pass next_cursor unchanged. Unprefixed
+   * cursors use legacy pagination. Shape and billing stay the same.
    *
    * @example
    * ```ts
@@ -236,7 +241,7 @@ export class Users extends APIResource {
    *
    * @example
    * ```ts
-   * const paginatedUsers =
+   * const response =
    *   await client.x.users.retrieveVerifiedFollowers('id');
    * ```
    */
@@ -244,7 +249,7 @@ export class Users extends APIResource {
     id: string,
     query: UserRetrieveVerifiedFollowersParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<Shared.PaginatedUsers> {
+  ): APIPromise<UserRetrieveVerifiedFollowersResponse> {
     return this._client.get(path`/x/users/${id}/verified-followers`, { query, ...options });
   }
 }
@@ -538,6 +543,288 @@ export interface UserRetrieveBatchResponse {
   users: Array<Shared.UserProfile>;
 }
 
+/**
+ * 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.
+ */
+export type UserRetrieveFollowersResponse =
+  | Shared.PaginatedUsers
+  | UserRetrieveFollowersResponse.UserListCoverageResponse;
+
+export 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.
+   */
+  export 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?: '';
+  }
+
+  export namespace UserListCoverageResponse {
+    /**
+     * Coverage evidence across parallel relationship strategies.
+     */
+    export interface Diagnostic {
+      /**
+       * True when every strategy exhausted its source.
+       */
+      complete: boolean;
+
+      cursorFailureCount: number;
+
+      deadlineReached: boolean;
+
+      duplicateCount: number;
+
+      failedStrategyCount: number;
+
+      malformedCount: number;
+
+      pagesFetched: number;
+
+      /**
+       * Whether credits or the requested limit reduced output.
+       */
+      responseTruncated: boolean;
+
+      resultLimitReached: boolean;
+
+      returnedUsers: number;
+
+      stalledStrategyCount: number;
+
+      strategies: Array<Diagnostic.Strategy>;
+
+      strategyCount: number;
+
+      uniqueUsers: number;
+    }
+
+    export namespace Diagnostic {
+      export interface Strategy {
+        duplicateCount: number;
+
+        pagesFetched: number;
+
+        stopReason:
+          | 'cursor_failure'
+          | 'deadline'
+          | 'exhausted'
+          | 'failed'
+          | 'page_limit'
+          | 'result_limit'
+          | 'stalled';
+
+        strategy: number;
+
+        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.
+ */
+export type UserRetrieveFollowingResponse =
+  | Shared.PaginatedUsers
+  | UserRetrieveFollowingResponse.UserListCoverageResponse;
+
+export 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.
+   */
+  export 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?: '';
+  }
+
+  export namespace UserListCoverageResponse {
+    /**
+     * Coverage evidence across parallel relationship strategies.
+     */
+    export interface Diagnostic {
+      /**
+       * True when every strategy exhausted its source.
+       */
+      complete: boolean;
+
+      cursorFailureCount: number;
+
+      deadlineReached: boolean;
+
+      duplicateCount: number;
+
+      failedStrategyCount: number;
+
+      malformedCount: number;
+
+      pagesFetched: number;
+
+      /**
+       * Whether credits or the requested limit reduced output.
+       */
+      responseTruncated: boolean;
+
+      resultLimitReached: boolean;
+
+      returnedUsers: number;
+
+      stalledStrategyCount: number;
+
+      strategies: Array<Diagnostic.Strategy>;
+
+      strategyCount: number;
+
+      uniqueUsers: number;
+    }
+
+    export namespace Diagnostic {
+      export interface Strategy {
+        duplicateCount: number;
+
+        pagesFetched: number;
+
+        stopReason:
+          | 'cursor_failure'
+          | 'deadline'
+          | 'exhausted'
+          | 'failed'
+          | 'page_limit'
+          | 'result_limit'
+          | 'stalled';
+
+        strategy: number;
+
+        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.
+ */
+export type UserRetrieveVerifiedFollowersResponse =
+  | Shared.PaginatedUsers
+  | UserRetrieveVerifiedFollowersResponse.UserListCoverageResponse;
+
+export namespace UserRetrieveVerifiedFollowersResponse {
+  /**
+   * 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.
+   */
+  export 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?: '';
+  }
+
+  export namespace UserListCoverageResponse {
+    /**
+     * Coverage evidence across parallel relationship strategies.
+     */
+    export interface Diagnostic {
+      /**
+       * True when every strategy exhausted its source.
+       */
+      complete: boolean;
+
+      cursorFailureCount: number;
+
+      deadlineReached: boolean;
+
+      duplicateCount: number;
+
+      failedStrategyCount: number;
+
+      malformedCount: number;
+
+      pagesFetched: number;
+
+      /**
+       * Whether credits or the requested limit reduced output.
+       */
+      responseTruncated: boolean;
+
+      resultLimitReached: boolean;
+
+      returnedUsers: number;
+
+      stalledStrategyCount: number;
+
+      strategies: Array<Diagnostic.Strategy>;
+
+      strategyCount: number;
+
+      uniqueUsers: number;
+    }
+
+    export namespace Diagnostic {
+      export interface Strategy {
+        duplicateCount: number;
+
+        pagesFetched: number;
+
+        stopReason:
+          | 'cursor_failure'
+          | 'deadline'
+          | 'exhausted'
+          | 'failed'
+          | 'page_limit'
+          | 'result_limit'
+          | 'stalled';
+
+        strategy: number;
+
+        uniqueAdded: number;
+      }
+    }
+  }
+}
+
 export interface UserRemoveFollowerParams {
   /**
    * Body param: X account identifier (@username or account ID)
@@ -568,395 +855,381 @@ export interface UserRetrieveFollowersParams {
   after?: string;
 
   /**
-   * Pagination cursor for followers list
+   * Match any comma-separated or line-separated bio term, ignoring case.
    */
-  cursor?: string;
+  bioContains?: string;
 
   /**
-   * Legacy integer page size alias for following lists. Prefer pageSize.
+   * Cursor from the previous response. Xquik cursors resume automatic coverage.
+   * Existing unprefixed cursors keep legacy standard behavior.
    */
-  limit?: number;
+  cursor?: string;
 
   /**
-   * Maximum user profiles requested from this page (20-200, default 200). The
-   * response can contain fewer profiles because the source returned fewer or
-   * the available usage balance covers fewer results. Keep requesting next_cursor while
-   * has_next_page is true. The deprecated limit and count aliases remain accepted.
+   * Only return profiles with a location.
    */
-  pageSize?: number;
-}
+  hasLocation?: boolean;
 
-export interface UserRetrieveFollowersYouKnowParams {
   /**
-   * Pagination cursor for followers-you-know
+   * Only return profiles with a website.
    */
-  cursor?: string;
+  hasWebsite?: boolean;
 
   /**
-   * Maximum user profiles requested from this page (20-200, default 200). The
-   * response can contain fewer profiles because the source returned fewer or
-   * the available usage balance covers fewer results. Keep requesting next_cursor while
-   * has_next_page is true. The deprecated limit and count aliases remain accepted.
+   * Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
+   * Prefer pageSize.
    */
-  pageSize?: number;
-}
+  limit?: number;
 
-export interface UserRetrieveFollowingParams {
   /**
-   * Deprecated following cursor alias. Prefer cursor.
+   * Match a location substring, ignoring case.
    */
-  after?: string;
+  locationContains?: string;
 
   /**
-   * Pagination cursor for following list
+   * Maximum follower count. Missing counts pass this maximum.
    */
-  cursor?: string;
+  maxFollowers?: number;
 
   /**
-   * Legacy page size alias. Prefer pageSize.
+   * Maximum following count.
    */
-  limit?: number;
+  maxFollowing?: number;
 
   /**
-   * Maximum user profiles requested from this page (20-200, default 200). The
-   * response can contain fewer profiles because the source returned fewer or
-   * the available usage balance covers fewer results. Keep requesting next_cursor while
-   * has_next_page is true. The deprecated limit and count aliases remain accepted.
+   * Maximum post count. maxPosts is also accepted.
    */
-  pageSize?: number;
-}
+  maxStatuses?: number;
 
-export interface UserRetrieveLikesParams {
   /**
-   * Words or quoted phrases where any one can match. Separate with spaces, commas,
-   * or lines.
+   * Minimum account age in whole days.
    */
-  anyWords?: string;
+  minAccountAgeDays?: number;
 
   /**
-   * Cashtags separated by spaces, commas, or lines.
+   * Minimum follower count. Filtering happens before billing.
    */
-  cashtags?: string;
+  minFollowers?: number;
 
   /**
-   * Conversation ID filter.
+   * Minimum following count.
    */
-  conversationId?: string;
+  minFollowing?: number;
 
   /**
-   * Pagination cursor for liked tweets
+   * Minimum post count. minPosts is also accepted.
    */
-  cursor?: string;
+  minStatuses?: number;
 
   /**
-   * Exact phrase to match.
+   * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
+   * Coverage returns diagnostics once and rejects cursors.
    */
-  exactPhrase?: string;
+  mode?: 'standard' | 'coverage';
 
   /**
-   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   * Maximum user profiles: automatic 300; standard 200. Sources return fewer
+   * profiles. Continue with has_next_page.
    */
-  excludeWords?: string;
+  pageSize?: number;
 
   /**
-   * Filter by author username.
+   * Match a username substring, ignoring case.
    */
-  fromUser?: string;
+  usernameContains?: string;
 
   /**
-   * Hashtags separated by spaces, commas, or lines.
+   * Only return verified profiles.
    */
-  hashtags?: string;
+  verifiedOnly?: boolean;
 
   /**
-   * Only replies to this tweet ID.
+   * Match the verification type exactly, ignoring case.
    */
-  inReplyToTweetId?: string;
+  verifiedType?: string;
+}
 
+export interface UserRetrieveFollowersYouKnowParams {
   /**
-   * Language code filter, e.g. en or tr.
+   * Match any comma-separated or line-separated bio term, ignoring case.
    */
-  language?: string;
+  bioContains?: string;
 
   /**
-   * Filter by media type.
+   * Pagination cursor for followers-you-know
    */
-  mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+  cursor?: string;
 
   /**
-   * Filter tweets mentioning a username.
+   * Only return profiles with a location.
    */
-  mentioning?: string;
+  hasLocation?: boolean;
 
   /**
-   * Minimum likes threshold.
+   * Only return profiles with a website.
    */
-  minFaves?: number;
+  hasWebsite?: boolean;
 
   /**
-   * Minimum quote count threshold.
+   * Match a location substring, ignoring case.
    */
-  minQuotes?: number;
+  locationContains?: string;
 
   /**
-   * Minimum replies threshold.
+   * Maximum follower count. Missing counts pass this maximum.
    */
-  minReplies?: number;
+  maxFollowers?: number;
 
   /**
-   * Minimum retweets threshold.
+   * Maximum following count.
    */
-  minRetweets?: number;
+  maxFollowing?: number;
 
   /**
-   * 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.
+   * Maximum post count. maxPosts is also accepted.
    */
-  pageSize?: number;
+  maxStatuses?: number;
 
   /**
-   * Quote mode.
+   * Minimum account age in whole days.
    */
-  quotes?: 'include' | 'exclude' | 'only';
+  minAccountAgeDays?: number;
 
   /**
-   * Only quotes of this tweet ID.
+   * Minimum follower count. Filtering happens before billing.
    */
-  quotesOfTweetId?: string;
+  minFollowers?: number;
 
   /**
-   * Reply mode.
+   * Minimum following count.
    */
-  replies?: 'include' | 'exclude' | 'only';
+  minFollowing?: number;
 
   /**
-   * Retweet mode.
+   * Minimum post count. minPosts is also accepted.
    */
-  retweets?: 'include' | 'exclude' | 'only';
+  minStatuses?: number;
 
   /**
-   * Only retweets of this tweet ID.
+   * 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.
    */
-  retweetsOfTweetId?: string;
+  pageSize?: number;
 
   /**
-   * Start date in YYYY-MM-DD format.
+   * Match a username substring, ignoring case.
    */
-  sinceDate?: string;
+  usernameContains?: string;
 
   /**
-   * Filter replies sent to a username.
+   * Only return verified profiles.
    */
-  toUser?: string;
+  verifiedOnly?: boolean;
 
   /**
-   * End date in YYYY-MM-DD format.
+   * Match the verification type exactly, ignoring case.
    */
-  untilDate?: string;
+  verifiedType?: string;
+}
 
+export interface UserRetrieveFollowingParams {
   /**
-   * URL substring or domain filter.
+   * Deprecated following cursor alias. Prefer cursor.
    */
-  url?: string;
+  after?: string;
 
   /**
-   * Only return tweets from verified authors.
+   * Match any comma-separated or line-separated bio term, ignoring case.
    */
-  verifiedOnly?: boolean;
-}
+  bioContains?: string;
 
-export interface UserRetrieveMediaParams {
   /**
-   * Words or quoted phrases where any one can match. Separate with spaces, commas,
-   * or lines.
+   * Cursor from the previous response. Xquik cursors resume automatic coverage.
+   * Existing unprefixed cursors keep legacy standard behavior.
    */
-  anyWords?: string;
+  cursor?: string;
 
   /**
-   * Cashtags separated by spaces, commas, or lines.
+   * Only return profiles with a location.
    */
-  cashtags?: string;
+  hasLocation?: boolean;
 
   /**
-   * Conversation ID filter.
+   * Only return profiles with a website.
    */
-  conversationId?: string;
+  hasWebsite?: boolean;
 
   /**
-   * Pagination cursor for media tweets
+   * Legacy page-size alias outside explicit coverage mode. Coverage accepts 1-10000.
+   * Prefer pageSize.
    */
-  cursor?: string;
+  limit?: number;
 
   /**
-   * Exact phrase to match.
+   * Match a location substring, ignoring case.
    */
-  exactPhrase?: string;
+  locationContains?: string;
 
   /**
-   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   * Maximum follower count. Missing counts pass this maximum.
    */
-  excludeWords?: string;
+  maxFollowers?: number;
 
   /**
-   * Filter by author username.
+   * Maximum following count.
    */
-  fromUser?: string;
+  maxFollowing?: number;
 
   /**
-   * Hashtags separated by spaces, commas, or lines.
+   * Maximum post count. maxPosts is also accepted.
    */
-  hashtags?: string;
+  maxStatuses?: number;
 
   /**
-   * Only replies to this tweet ID.
+   * Minimum account age in whole days.
    */
-  inReplyToTweetId?: string;
+  minAccountAgeDays?: number;
 
   /**
-   * Language code filter, e.g. en or tr.
+   * Minimum follower count. Filtering happens before billing.
    */
-  language?: string;
+  minFollowers?: number;
 
   /**
-   * Filter by media type.
+   * Minimum following count.
    */
-  mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+  minFollowing?: number;
 
   /**
-   * Filter tweets mentioning a username.
+   * Minimum post count. minPosts is also accepted.
    */
-  mentioning?: string;
+  minStatuses?: number;
 
   /**
-   * Minimum likes threshold.
+   * Omit mode for resumable maximum coverage. Standard keeps legacy pagination.
+   * Coverage returns diagnostics once and rejects cursors.
    */
-  minFaves?: number;
+  mode?: 'standard' | 'coverage';
 
   /**
-   * Minimum quote count threshold.
+   * Maximum user profiles: automatic 300; standard 200. Sources return fewer
+   * profiles. Continue with has_next_page.
    */
-  minQuotes?: number;
+  pageSize?: number;
 
   /**
-   * Minimum replies threshold.
+   * Match a username substring, ignoring case.
    */
-  minReplies?: number;
+  usernameContains?: string;
 
   /**
-   * Minimum retweets threshold.
+   * Only return verified profiles.
    */
-  minRetweets?: number;
+  verifiedOnly?: 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.
+   * Match the verification type exactly, ignoring case.
    */
-  pageSize?: number;
+  verifiedType?: string;
+}
 
+export interface UserRetrieveLikesParams {
   /**
-   * Quote mode.
+   * Words or quoted phrases where any one can match. Separate with spaces, commas,
+   * or lines.
    */
-  quotes?: 'include' | 'exclude' | 'only';
+  anyWords?: string;
 
   /**
-   * Only quotes of this tweet ID.
+   * Only return tweets from Blue-verified authors.
    */
-  quotesOfTweetId?: string;
+  blueVerifiedOnly?: boolean;
 
   /**
-   * Reply mode.
+   * Match the Tweet card name.
    */
-  replies?: 'include' | 'exclude' | 'only';
+  cardName?: string;
 
   /**
-   * Retweet mode.
+   * Cashtags separated by spaces, commas, or lines.
    */
-  retweets?: 'include' | 'exclude' | 'only';
-
-  /**
-   * Only retweets of this tweet ID.
-   */
-  retweetsOfTweetId?: string;
+  cashtags?: string;
 
   /**
-   * Start date in YYYY-MM-DD format.
+   * Conversation ID filter.
    */
-  sinceDate?: string;
+  conversationId?: string;
 
   /**
-   * Filter replies sent to a username.
+   * Pagination cursor for liked tweets
    */
-  toUser?: string;
+  cursor?: string;
 
   /**
-   * End date in YYYY-MM-DD format.
+   * Exact phrase to match.
    */
-  untilDate?: string;
+  exactPhrase?: string;
 
   /**
-   * URL substring or domain filter.
+   * Exclude a source application.
    */
-  url?: string;
+  excludeSource?: string;
 
   /**
-   * Only return tweets from verified authors.
+   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
    */
-  verifiedOnly?: boolean;
-}
+  excludeWords?: string;
 
-export interface UserRetrieveMentionsParams {
   /**
-   * Words or quoted phrases where any one can match. Separate with spaces, commas,
-   * or lines.
+   * Filter by author username.
    */
-  anyWords?: string;
+  fromUser?: string;
 
   /**
-   * Cashtags separated by spaces, commas, or lines.
+   * Match latitude, longitude, and radius.
    */
-  cashtags?: string;
+  geocode?: string;
 
   /**
-   * Conversation ID filter.
+   * Hashtags separated by spaces, commas, or lines.
    */
-  conversationId?: string;
+  hashtags?: string;
 
   /**
-   * Pagination cursor for mentions
+   * Only replies to this tweet ID.
    */
-  cursor?: string;
+  inReplyToTweetId?: string;
 
   /**
-   * Exact phrase to match.
+   * Language code filter, e.g. en or tr.
    */
-  exactPhrase?: string;
+  language?: string;
 
   /**
-   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   * Maximum likes threshold. maxLikes is also accepted.
    */
-  excludeWords?: string;
+  maxFaves?: number;
 
   /**
-   * Filter by author username.
+   * Return Tweets older than this Tweet ID.
    */
-  fromUser?: string;
+  maxId?: string;
 
   /**
-   * Hashtags separated by spaces, commas, or lines.
+   * Maximum quotes threshold.
    */
-  hashtags?: string;
+  maxQuotes?: number;
 
   /**
-   * Only replies to this tweet ID.
+   * Maximum replies threshold.
    */
-  inReplyToTweetId?: string;
+  maxReplies?: number;
 
   /**
-   * Language code filter, e.g. en or tr.
+   * Maximum retweets threshold.
    */
-  language?: string;
+  maxRetweets?: number;
 
   /**
    * Filter by media type.
@@ -968,6 +1241,11 @@ export interface UserRetrieveMentionsParams {
    */
   mentioning?: string;
 
+  /**
+   * Minimum bookmark count threshold.
+   */
+  minBookmarks?: number;
+
   /**
    * Minimum likes threshold.
    */
@@ -988,6 +1266,26 @@ export interface UserRetrieveMentionsParams {
    */
   minRetweets?: number;
 
+  /**
+   * Minimum view count threshold.
+   */
+  minViews?: number;
+
+  /**
+   * Only return native reposts.
+   */
+  nativeRetweets?: boolean;
+
+  /**
+   * Match a place name.
+   */
+  near?: string;
+
+  /**
+   * Only return news results.
+   */
+  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
@@ -1020,15 +1318,25 @@ export interface UserRetrieveMentionsParams {
    */
   retweetsOfTweetId?: string;
 
+  /**
+   * Enable the safe-search filter.
+   */
+  safe?: boolean;
+
   /**
    * Start date in YYYY-MM-DD format.
    */
   sinceDate?: string;
 
   /**
-   * Unix timestamp - return mentions after this time
+   * Return Tweets newer than this Tweet ID.
    */
-  sinceTime?: string;
+  sinceId?: string;
+
+  /**
+   * Match the source application.
+   */
+  source?: string;
 
   /**
    * Filter replies sent to a username.
@@ -1040,11 +1348,6 @@ export interface UserRetrieveMentionsParams {
    */
   untilDate?: string;
 
-  /**
-   * Unix timestamp - return mentions before this time
-   */
-  untilTime?: string;
-
   /**
    * URL substring or domain filter.
    */
@@ -1054,15 +1357,35 @@ export interface UserRetrieveMentionsParams {
    * Only return tweets from verified authors.
    */
   verifiedOnly?: boolean;
+
+  /**
+   * Set the radius for the near filter.
+   */
+  within?: string;
+
+  /**
+   * Match Tweets inside a recent time window.
+   */
+  withinTime?: string;
 }
 
-export interface UserRetrieveRepliesParams {
+export interface UserRetrieveMediaParams {
   /**
    * 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;
+
+  /**
+   * Match the Tweet card name.
+   */
+  cardName?: string;
+
   /**
    * Cashtags separated by spaces, commas, or lines.
    */
@@ -1074,7 +1397,7 @@ export interface UserRetrieveRepliesParams {
   conversationId?: string;
 
   /**
-   * Pagination cursor for user replies
+   * Pagination cursor for media tweets
    */
   cursor?: string;
 
@@ -1083,6 +1406,11 @@ export interface UserRetrieveRepliesParams {
    */
   exactPhrase?: string;
 
+  /**
+   * Exclude a source application.
+   */
+  excludeSource?: string;
+
   /**
    * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
    */
@@ -1094,14 +1422,14 @@ export interface UserRetrieveRepliesParams {
   fromUser?: string;
 
   /**
-   * Hashtags separated by spaces, commas, or lines.
+   * Match latitude, longitude, and radius.
    */
-  hashtags?: string;
+  geocode?: string;
 
   /**
-   * Include each reply's parent tweet.
+   * Hashtags separated by spaces, commas, or lines.
    */
-  includeParentTweet?: boolean;
+  hashtags?: string;
 
   /**
    * Only replies to this tweet ID.
@@ -1113,6 +1441,31 @@ export interface UserRetrieveRepliesParams {
    */
   language?: string;
 
+  /**
+   * Maximum likes threshold. maxLikes is also accepted.
+   */
+  maxFaves?: number;
+
+  /**
+   * Return Tweets older than this Tweet ID.
+   */
+  maxId?: string;
+
+  /**
+   * Maximum quotes threshold.
+   */
+  maxQuotes?: number;
+
+  /**
+   * Maximum replies threshold.
+   */
+  maxReplies?: number;
+
+  /**
+   * Maximum retweets threshold.
+   */
+  maxRetweets?: number;
+
   /**
    * Filter by media type.
    */
@@ -1123,6 +1476,11 @@ export interface UserRetrieveRepliesParams {
    */
   mentioning?: string;
 
+  /**
+   * Minimum bookmark count threshold.
+   */
+  minBookmarks?: number;
+
   /**
    * Minimum likes threshold.
    */
@@ -1143,6 +1501,26 @@ export interface UserRetrieveRepliesParams {
    */
   minRetweets?: number;
 
+  /**
+   * Minimum view count threshold.
+   */
+  minViews?: number;
+
+  /**
+   * Only return native reposts.
+   */
+  nativeRetweets?: boolean;
+
+  /**
+   * Match a place name.
+   */
+  near?: string;
+
+  /**
+   * Only return news results.
+   */
+  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
@@ -1175,11 +1553,26 @@ export interface UserRetrieveRepliesParams {
    */
   retweetsOfTweetId?: string;
 
+  /**
+   * Enable the safe-search filter.
+   */
+  safe?: boolean;
+
   /**
    * Start date in YYYY-MM-DD format.
    */
   sinceDate?: string;
 
+  /**
+   * Return Tweets newer than this Tweet ID.
+   */
+  sinceId?: string;
+
+  /**
+   * Match the source application.
+   */
+  source?: string;
+
   /**
    * Filter replies sent to a username.
    */
@@ -1199,27 +1592,35 @@ export interface UserRetrieveRepliesParams {
    * Only return tweets from verified authors.
    */
   verifiedOnly?: boolean;
-}
 
-export interface UserRetrieveSearchParams {
   /**
-   * User search query
+   * Set the radius for the near filter.
    */
-  q: string;
+  within?: string;
 
   /**
-   * Pagination cursor for user search
+   * Match Tweets inside a recent time window.
    */
-  cursor?: string;
+  withinTime?: string;
 }
 
-export interface UserRetrieveTweetsParams {
+export interface UserRetrieveMentionsParams {
   /**
    * 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;
+
+  /**
+   * Match the Tweet card name.
+   */
+  cardName?: string;
+
   /**
    * Cashtags separated by spaces, commas, or lines.
    */
@@ -1231,7 +1632,7 @@ export interface UserRetrieveTweetsParams {
   conversationId?: string;
 
   /**
-   * Pagination cursor for user tweets
+   * Pagination cursor for mentions
    */
   cursor?: string;
 
@@ -1240,6 +1641,11 @@ export interface UserRetrieveTweetsParams {
    */
   exactPhrase?: string;
 
+  /**
+   * Exclude a source application.
+   */
+  excludeSource?: string;
+
   /**
    * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
    */
@@ -1250,30 +1656,50 @@ export interface UserRetrieveTweetsParams {
    */
   fromUser?: string;
 
+  /**
+   * Match latitude, longitude, and radius.
+   */
+  geocode?: string;
+
   /**
    * Hashtags separated by spaces, commas, or lines.
    */
   hashtags?: string;
 
   /**
-   * Include parent tweet for replies
+   * Only replies to this tweet ID.
    */
-  includeParentTweet?: boolean;
+  inReplyToTweetId?: string;
 
   /**
-   * Include reply tweets
+   * Language code filter, e.g. en or tr.
    */
-  includeReplies?: boolean;
+  language?: string;
 
   /**
-   * Only replies to this tweet ID.
+   * Maximum likes threshold. maxLikes is also accepted.
    */
-  inReplyToTweetId?: string;
+  maxFaves?: number;
 
   /**
-   * Language code filter, e.g. en or tr.
+   * Return Tweets older than this Tweet ID.
    */
-  language?: string;
+  maxId?: string;
+
+  /**
+   * Maximum quotes threshold.
+   */
+  maxQuotes?: number;
+
+  /**
+   * Maximum replies threshold.
+   */
+  maxReplies?: number;
+
+  /**
+   * Maximum retweets threshold.
+   */
+  maxRetweets?: number;
 
   /**
    * Filter by media type.
@@ -1285,6 +1711,11 @@ export interface UserRetrieveTweetsParams {
    */
   mentioning?: string;
 
+  /**
+   * Minimum bookmark count threshold.
+   */
+  minBookmarks?: number;
+
   /**
    * Minimum likes threshold.
    */
@@ -1305,6 +1736,26 @@ export interface UserRetrieveTweetsParams {
    */
   minRetweets?: number;
 
+  /**
+   * Minimum view count threshold.
+   */
+  minViews?: number;
+
+  /**
+   * Only return native reposts.
+   */
+  nativeRetweets?: boolean;
+
+  /**
+   * Match a place name.
+   */
+  near?: string;
+
+  /**
+   * Only return news results.
+   */
+  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
@@ -1337,11 +1788,31 @@ export interface UserRetrieveTweetsParams {
    */
   retweetsOfTweetId?: string;
 
+  /**
+   * Enable the safe-search filter.
+   */
+  safe?: boolean;
+
   /**
    * Start date in YYYY-MM-DD format.
    */
   sinceDate?: string;
 
+  /**
+   * Return Tweets newer than this Tweet ID.
+   */
+  sinceId?: string;
+
+  /**
+   * Unix timestamp - return mentions after this time
+   */
+  sinceTime?: string;
+
+  /**
+   * Match the source application.
+   */
+  source?: string;
+
   /**
    * Filter replies sent to a username.
    */
@@ -1352,6 +1823,11 @@ export interface UserRetrieveTweetsParams {
    */
   untilDate?: string;
 
+  /**
+   * Unix timestamp - return mentions before this time
+   */
+  untilTime?: string;
+
   /**
    * URL substring or domain filter.
    */
@@ -1361,21 +1837,684 @@ export interface UserRetrieveTweetsParams {
    * Only return tweets from verified authors.
    */
   verifiedOnly?: boolean;
+
+  /**
+   * Set the radius for the near filter.
+   */
+  within?: string;
+
+  /**
+   * Match Tweets inside a recent time window.
+   */
+  withinTime?: string;
 }
 
-export interface UserRetrieveVerifiedFollowersParams {
+export interface UserRetrieveRepliesParams {
+  /**
+   * 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;
+
   /**
-   * Pagination cursor for verified followers
+   * Match the Tweet card name.
+   */
+  cardName?: string;
+
+  /**
+   * Cashtags separated by spaces, commas, or lines.
+   */
+  cashtags?: string;
+
+  /**
+   * Conversation ID filter.
+   */
+  conversationId?: string;
+
+  /**
+   * Cursor from the previous response. Xquik cursors resume automatic coverage.
+   * Existing unprefixed cursors keep legacy standard behavior.
    */
   cursor?: string;
 
   /**
-   * Maximum user profiles requested from this page (20-200, default 200). The
-   * response can contain fewer profiles because the source returned fewer or
-   * the available usage balance covers fewer results. Keep requesting next_cursor while
-   * has_next_page is true. The deprecated limit and count aliases remain accepted.
+   * Exact phrase to match.
    */
-  pageSize?: number;
+  exactPhrase?: string;
+
+  /**
+   * Exclude a source application.
+   */
+  excludeSource?: string;
+
+  /**
+   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   */
+  excludeWords?: string;
+
+  /**
+   * Filter by author username.
+   */
+  fromUser?: string;
+
+  /**
+   * Match latitude, longitude, and radius.
+   */
+  geocode?: string;
+
+  /**
+   * Hashtags separated by spaces, commas, or lines.
+   */
+  hashtags?: string;
+
+  /**
+   * Include each reply's parent tweet.
+   */
+  includeParentTweet?: boolean;
+
+  /**
+   * Only replies to this tweet ID.
+   */
+  inReplyToTweetId?: string;
+
+  /**
+   * Language code filter, e.g. en or tr.
+   */
+  language?: string;
+
+  /**
+   * Maximum likes threshold. maxLikes is also accepted.
+   */
+  maxFaves?: number;
+
+  /**
+   * Return Tweets older than this Tweet ID.
+   */
+  maxId?: string;
+
+  /**
+   * Maximum quotes threshold.
+   */
+  maxQuotes?: number;
+
+  /**
+   * Maximum replies threshold.
+   */
+  maxReplies?: number;
+
+  /**
+   * Maximum retweets threshold.
+   */
+  maxRetweets?: number;
+
+  /**
+   * Filter by media type.
+   */
+  mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+
+  /**
+   * Filter tweets mentioning a username.
+   */
+  mentioning?: string;
+
+  /**
+   * Minimum bookmark count threshold.
+   */
+  minBookmarks?: number;
+
+  /**
+   * Minimum likes threshold.
+   */
+  minFaves?: 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;
+
+  /**
+   * Match a place name.
+   */
+  near?: string;
+
+  /**
+   * Only return news results.
+   */
+  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.
+   */
+  pageSize?: number;
+
+  /**
+   * Quote mode.
+   */
+  quotes?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Only quotes of this tweet ID.
+   */
+  quotesOfTweetId?: string;
+
+  /**
+   * Reply mode.
+   */
+  replies?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Retweet mode.
+   */
+  retweets?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Only retweets of this tweet ID.
+   */
+  retweetsOfTweetId?: string;
+
+  /**
+   * Enable the safe-search filter.
+   */
+  safe?: boolean;
+
+  /**
+   * Start date in YYYY-MM-DD format.
+   */
+  sinceDate?: string;
+
+  /**
+   * Return Tweets newer than this Tweet ID.
+   */
+  sinceId?: string;
+
+  /**
+   * Match the source application.
+   */
+  source?: string;
+
+  /**
+   * Filter replies sent to a username.
+   */
+  toUser?: string;
+
+  /**
+   * End date in YYYY-MM-DD format.
+   */
+  untilDate?: string;
+
+  /**
+   * URL substring or domain filter.
+   */
+  url?: string;
+
+  /**
+   * Only return tweets from verified authors.
+   */
+  verifiedOnly?: boolean;
+
+  /**
+   * Set the radius for the near filter.
+   */
+  within?: string;
+
+  /**
+   * Match Tweets inside a recent time window.
+   */
+  withinTime?: string;
+}
+
+export interface UserRetrieveSearchParams {
+  /**
+   * User search query
+   */
+  q: string;
+
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
+  /**
+   * Pagination cursor for user search
+   */
+  cursor?: string;
+
+  /**
+   * 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;
+
+  /**
+   * Maximum following count.
+   */
+  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;
+
+  /**
+   * Minimum following count.
+   */
+  minFollowing?: number;
+
+  /**
+   * Minimum post count. minPosts is also accepted.
+   */
+  minStatuses?: 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 UserRetrieveTweetsParams {
+  /**
+   * 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;
+
+  /**
+   * Match the Tweet card name.
+   */
+  cardName?: string;
+
+  /**
+   * Cashtags separated by spaces, commas, or lines.
+   */
+  cashtags?: string;
+
+  /**
+   * Conversation ID filter.
+   */
+  conversationId?: string;
+
+  /**
+   * Cursor from the previous response. Xquik cursors resume automatic coverage.
+   * Existing unprefixed cursors keep legacy standard behavior.
+   */
+  cursor?: string;
+
+  /**
+   * Exact phrase to match.
+   */
+  exactPhrase?: string;
+
+  /**
+   * Exclude a source application.
+   */
+  excludeSource?: string;
+
+  /**
+   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   */
+  excludeWords?: string;
+
+  /**
+   * Filter by author username.
+   */
+  fromUser?: string;
+
+  /**
+   * Match latitude, longitude, and radius.
+   */
+  geocode?: string;
+
+  /**
+   * Hashtags separated by spaces, commas, or lines.
+   */
+  hashtags?: string;
+
+  /**
+   * Include parent tweet for replies
+   */
+  includeParentTweet?: boolean;
+
+  /**
+   * Include reply tweets
+   */
+  includeReplies?: boolean;
+
+  /**
+   * Only replies to this tweet ID.
+   */
+  inReplyToTweetId?: string;
+
+  /**
+   * Language code filter, e.g. en or tr.
+   */
+  language?: string;
+
+  /**
+   * Maximum likes threshold. maxLikes is also accepted.
+   */
+  maxFaves?: number;
+
+  /**
+   * Return Tweets older than this Tweet ID.
+   */
+  maxId?: string;
+
+  /**
+   * Maximum quotes threshold.
+   */
+  maxQuotes?: number;
+
+  /**
+   * Maximum replies threshold.
+   */
+  maxReplies?: number;
+
+  /**
+   * Maximum retweets threshold.
+   */
+  maxRetweets?: number;
+
+  /**
+   * Filter by media type.
+   */
+  mediaType?: 'images' | 'videos' | 'gifs' | 'media' | 'links' | 'none';
+
+  /**
+   * Filter tweets mentioning a username.
+   */
+  mentioning?: string;
+
+  /**
+   * Minimum bookmark count threshold.
+   */
+  minBookmarks?: number;
+
+  /**
+   * Minimum likes threshold.
+   */
+  minFaves?: 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;
+
+  /**
+   * Match a place name.
+   */
+  near?: string;
+
+  /**
+   * Only return news results.
+   */
+  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.
+   */
+  pageSize?: number;
+
+  /**
+   * Quote mode.
+   */
+  quotes?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Only quotes of this tweet ID.
+   */
+  quotesOfTweetId?: string;
+
+  /**
+   * Reply mode.
+   */
+  replies?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Retweet mode.
+   */
+  retweets?: 'include' | 'exclude' | 'only';
+
+  /**
+   * Only retweets of this tweet ID.
+   */
+  retweetsOfTweetId?: string;
+
+  /**
+   * Enable the safe-search filter.
+   */
+  safe?: boolean;
+
+  /**
+   * Start date in YYYY-MM-DD format.
+   */
+  sinceDate?: string;
+
+  /**
+   * Return Tweets newer than this Tweet ID.
+   */
+  sinceId?: string;
+
+  /**
+   * Match the source application.
+   */
+  source?: string;
+
+  /**
+   * Filter replies sent to a username.
+   */
+  toUser?: string;
+
+  /**
+   * End date in YYYY-MM-DD format.
+   */
+  untilDate?: string;
+
+  /**
+   * URL substring or domain filter.
+   */
+  url?: string;
+
+  /**
+   * Only return tweets from verified authors.
+   */
+  verifiedOnly?: boolean;
+
+  /**
+   * Set the radius for the near filter.
+   */
+  within?: string;
+
+  /**
+   * Match Tweets inside a recent time window.
+   */
+  withinTime?: string;
+}
+
+export interface UserRetrieveVerifiedFollowersParams {
+  /**
+   * Legacy cursor alias. Prefer cursor.
+   */
+  after?: string;
+
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
+  /**
+   * Cursor from the previous response. Xquik cursors resume automatic coverage.
+   * Existing unprefixed cursors keep legacy standard behavior.
+   */
+  cursor?: string;
+
+  /**
+   * Only return profiles with a location.
+   */
+  hasLocation?: boolean;
+
+  /**
+   * Only return profiles with a website.
+   */
+  hasWebsite?: boolean;
+
+  /**
+   * Legacy page-size alias outside explicit 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;
+
+  /**
+   * Maximum following count.
+   */
+  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;
+
+  /**
+   * Minimum following count.
+   */
+  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';
+
+  /**
+   * Maximum user profiles: automatic 300; standard 200. Sources return fewer
+   * profiles. Continue with has_next_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;
 }
 
 Users.Follow = Follow;
@@ -1384,6 +2523,9 @@ 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,