x-twitter-scraper 0.8.4 → 0.11.0

package/resources/x/users/users.d.mts

@@ -43,11 +43,12 @@ export declare 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>;
+    retrieveFollowers(id: string, query?: UserRetrieveFollowersParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowersResponse>;
     /**
      * List mutual followers between you and a user
      *
@@ -63,11 +64,12 @@ export declare 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>;
+    retrieveFollowing(id: string, query?: UserRetrieveFollowingParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveFollowingResponse>;
     /**
      * List tweets liked by a user
      *
@@ -101,7 +103,9 @@ export declare class Users extends APIResource {
      */
     retrieveMentions(id: string, query?: UserRetrieveMentionsParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedTweets>;
     /**
-     * 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
@@ -122,7 +126,8 @@ export declare class Users extends APIResource {
      */
     retrieveSearch(query: UserRetrieveSearchParams, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
     /**
-     * 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
@@ -137,11 +142,11 @@ export declare class Users extends APIResource {
      *
      * @example
      * ```ts
-     * const paginatedUsers =
+     * const response =
      *   await client.x.users.retrieveVerifiedFollowers('id');
      * ```
      */
-    retrieveVerifiedFollowers(id: string, query?: UserRetrieveVerifiedFollowersParams | null | undefined, options?: RequestOptions): APIPromise<Shared.PaginatedUsers>;
+    retrieveVerifiedFollowers(id: string, query?: UserRetrieveVerifiedFollowersParams | null | undefined, options?: RequestOptions): APIPromise<UserRetrieveVerifiedFollowersResponse>;
 }
 /**
  * Durable write lifecycle record. Poll statusUrl until terminal is true. Reusing
@@ -352,6 +357,189 @@ export interface UserRetrieveBatchResponse {
     unprocessed_ids: Array<string>;
     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 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.
+     */
+    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 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;
+        }
+        namespace Diagnostic {
+            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 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.
+     */
+    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 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;
+        }
+        namespace Diagnostic {
+            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 declare 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.
+     */
+    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 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;
+        }
+        namespace Diagnostic {
+            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)
@@ -378,33 +566,149 @@ export interface UserRetrieveFollowersParams {
      */
     after?: string;
     /**
-     * Pagination cursor for followers list
+     * 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;
     /**
-     * Legacy integer page size alias for following lists. Prefer pageSize.
+     * 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;
     /**
-     * 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.
+     * 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;
 }
 export interface UserRetrieveFollowersYouKnowParams {
+    /**
+     * Match any comma-separated or line-separated bio term, ignoring case.
+     */
+    bioContains?: string;
     /**
      * Pagination cursor for followers-you-know
      */
     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.
+     */
+    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;
+    /**
+     * 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.
      */
     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 {
     /**
@@ -412,20 +716,81 @@ export interface UserRetrieveFollowingParams {
      */
     after?: string;
     /**
-     * Pagination cursor for following list
+     * 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;
     /**
-     * Legacy page size alias. Prefer pageSize.
+     * 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;
     /**
-     * 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.
+     * 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;
 }
 export interface UserRetrieveLikesParams {
     /**
@@ -433,6 +798,14 @@ export interface UserRetrieveLikesParams {
      * 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.
      */
@@ -449,6 +822,10 @@ export interface UserRetrieveLikesParams {
      * Exact phrase to match.
      */
     exactPhrase?: string;
+    /**
+     * Exclude a source application.
+     */
+    excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
@@ -457,6 +834,10 @@ export interface UserRetrieveLikesParams {
      * Filter by author username.
      */
     fromUser?: string;
+    /**
+     * Match latitude, longitude, and radius.
+     */
+    geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
@@ -469,6 +850,26 @@ export interface UserRetrieveLikesParams {
      * 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.
      */
@@ -477,6 +878,10 @@ export interface UserRetrieveLikesParams {
      * Filter tweets mentioning a username.
      */
     mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
     /**
      * Minimum likes threshold.
      */
@@ -493,6 +898,22 @@ export interface UserRetrieveLikesParams {
      * 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;
     /**
      * 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
@@ -519,10 +940,22 @@ export interface UserRetrieveLikesParams {
      * 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.
      */
@@ -539,6 +972,14 @@ export interface UserRetrieveLikesParams {
      * 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 UserRetrieveMediaParams {
     /**
@@ -546,6 +987,14 @@ export interface UserRetrieveMediaParams {
      * 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.
      */
@@ -562,6 +1011,10 @@ export interface UserRetrieveMediaParams {
      * Exact phrase to match.
      */
     exactPhrase?: string;
+    /**
+     * Exclude a source application.
+     */
+    excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
@@ -570,6 +1023,10 @@ export interface UserRetrieveMediaParams {
      * Filter by author username.
      */
     fromUser?: string;
+    /**
+     * Match latitude, longitude, and radius.
+     */
+    geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
@@ -582,6 +1039,26 @@ export interface UserRetrieveMediaParams {
      * 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.
      */
@@ -590,6 +1067,10 @@ export interface UserRetrieveMediaParams {
      * Filter tweets mentioning a username.
      */
     mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
     /**
      * Minimum likes threshold.
      */
@@ -606,6 +1087,22 @@ export interface UserRetrieveMediaParams {
      * 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;
     /**
      * 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
@@ -632,10 +1129,22 @@ export interface UserRetrieveMediaParams {
      * 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.
      */
@@ -652,6 +1161,14 @@ export interface UserRetrieveMediaParams {
      * 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 UserRetrieveMentionsParams {
     /**
@@ -659,6 +1176,14 @@ export interface UserRetrieveMentionsParams {
      * 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.
      */
@@ -675,6 +1200,10 @@ export interface UserRetrieveMentionsParams {
      * Exact phrase to match.
      */
     exactPhrase?: string;
+    /**
+     * Exclude a source application.
+     */
+    excludeSource?: string;
     /**
      * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
      */
@@ -683,6 +1212,10 @@ export interface UserRetrieveMentionsParams {
      * Filter by author username.
      */
     fromUser?: string;
+    /**
+     * Match latitude, longitude, and radius.
+     */
+    geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
@@ -695,6 +1228,26 @@ export interface UserRetrieveMentionsParams {
      * 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.
      */
@@ -703,6 +1256,10 @@ export interface UserRetrieveMentionsParams {
      * Filter tweets mentioning a username.
      */
     mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
     /**
      * Minimum likes threshold.
      */
@@ -719,6 +1276,22 @@ export interface UserRetrieveMentionsParams {
      * 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;
     /**
      * 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
@@ -745,14 +1318,26 @@ export interface UserRetrieveMentionsParams {
      * 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;
     /**
      * Unix timestamp - return mentions after this time
      */
     sinceTime?: string;
+    /**
+     * Match the source application.
+     */
+    source?: string;
     /**
      * Filter replies sent to a username.
      */
@@ -773,6 +1358,14 @@ 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 {
     /**
@@ -780,6 +1373,14 @@ export interface UserRetrieveRepliesParams {
      * 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.
      */
@@ -789,13 +1390,18 @@ export interface UserRetrieveRepliesParams {
      */
     conversationId?: string;
     /**
-     * Pagination cursor for user replies
+     * 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.
      */
@@ -804,6 +1410,10 @@ export interface UserRetrieveRepliesParams {
      * Filter by author username.
      */
     fromUser?: string;
+    /**
+     * Match latitude, longitude, and radius.
+     */
+    geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
@@ -820,6 +1430,26 @@ export interface UserRetrieveRepliesParams {
      * 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.
      */
@@ -828,6 +1458,10 @@ export interface UserRetrieveRepliesParams {
      * Filter tweets mentioning a username.
      */
     mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
     /**
      * Minimum likes threshold.
      */
@@ -845,9 +1479,24 @@ export interface UserRetrieveRepliesParams {
      */
     minRetweets?: 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.
+     * 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;
     /**
@@ -870,10 +1519,22 @@ export interface UserRetrieveRepliesParams {
      * 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.
      */
@@ -890,16 +1551,80 @@ export interface UserRetrieveRepliesParams {
      * 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 {
     /**
@@ -907,6 +1632,14 @@ export interface UserRetrieveTweetsParams {
      * 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.
      */
@@ -916,13 +1649,18 @@ export interface UserRetrieveTweetsParams {
      */
     conversationId?: string;
     /**
-     * Pagination cursor for user tweets
+     * 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.
      */
@@ -931,6 +1669,10 @@ export interface UserRetrieveTweetsParams {
      * Filter by author username.
      */
     fromUser?: string;
+    /**
+     * Match latitude, longitude, and radius.
+     */
+    geocode?: string;
     /**
      * Hashtags separated by spaces, commas, or lines.
      */
@@ -951,6 +1693,26 @@ export interface UserRetrieveTweetsParams {
      * 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.
      */
@@ -959,6 +1721,10 @@ export interface UserRetrieveTweetsParams {
      * Filter tweets mentioning a username.
      */
     mentioning?: string;
+    /**
+     * Minimum bookmark count threshold.
+     */
+    minBookmarks?: number;
     /**
      * Minimum likes threshold.
      */
@@ -976,9 +1742,24 @@ export interface UserRetrieveTweetsParams {
      */
     minRetweets?: 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.
+     * 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;
     /**
@@ -1001,10 +1782,22 @@ export interface UserRetrieveTweetsParams {
      * 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.
      */
@@ -1021,22 +1814,99 @@ 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 {
     /**
-     * Pagination cursor for verified followers
+     * 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;
     /**
-     * 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.
+     */
+    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;
 }
 export declare namespace Users {
-    export { type UserRemoveFollowerResponse as UserRemoveFollowerResponse, type UserRetrieveBatchResponse as UserRetrieveBatchResponse, 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 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 { Follow as Follow, type FollowCreateResponse as FollowCreateResponse, type FollowDeleteAllResponse as FollowDeleteAllResponse, type FollowCreateParams as FollowCreateParams, type FollowDeleteAllParams as FollowDeleteAllParams, };
 }
 //# sourceMappingURL=users.d.mts.map