x-twitter-scraper 0.11.0 → 0.12.1

package/src/resources/shared.ts

@@ -336,12 +336,17 @@ export interface Error {
     | 'idempotency_conflict'
     | 'idempotency_key_conflict'
     | 'invalid_community_id'
+    | 'invalid_complete_replies_request'
     | 'invalid_coverage_cursor'
+    | 'invalid_coverage_request'
     | 'invalid_idempotency_key'
     | 'invalid_list_id'
+    | 'invalid_output_options'
     | 'invalid_payment_amount'
     | 'invalid_range'
+    | 'invalid_reply_options'
     | 'login_rate_limited'
+    | 'login_service_unavailable'
     | 'missing_idempotency_key'
     | 'missing_ids'
     | 'no_cached_style'
@@ -352,6 +357,7 @@ export interface Error {
     | 'support_media_rate_limit'
     | 'support_request_rate_limit'
     | 'too_many_ids'
+    | 'too_many_tweets'
     | 'unknown_field'
     | 'unsupported_media_type'
     | 'webhook_inactive'
@@ -465,12 +471,17 @@ export namespace Error {
       | 'idempotency_conflict'
       | 'idempotency_key_conflict'
       | 'invalid_community_id'
+      | 'invalid_complete_replies_request'
       | 'invalid_coverage_cursor'
+      | 'invalid_coverage_request'
       | 'invalid_idempotency_key'
       | 'invalid_list_id'
+      | 'invalid_output_options'
       | 'invalid_payment_amount'
       | 'invalid_range'
+      | 'invalid_reply_options'
       | 'login_rate_limited'
+      | 'login_service_unavailable'
       | 'missing_idempotency_key'
       | 'missing_ids'
       | 'no_cached_style'
@@ -481,6 +492,7 @@ export namespace Error {
       | 'support_media_rate_limit'
       | 'support_request_rate_limit'
       | 'too_many_ids'
+      | 'too_many_tweets'
       | 'unknown_field'
       | 'unsupported_media_type'
       | 'webhook_inactive'

package/src/resources/x/tweets/tweets.ts

@@ -185,7 +185,9 @@ export class Tweets extends APIResource {
   }
 
   /**
-   * No-mode search maximizes coverage.
+   * No-mode search maximizes coverage. New cursorless `Latest` sessions return rows
+   * newest-first across cursor pages. Existing cursors preserve their established
+   * ordering.
    *
    * @example
    * ```ts
@@ -1210,8 +1212,10 @@ export namespace TweetSearchResponse {
    * cursors remain legacy. Follow next_cursor while has_next_page is true. An empty
    * filtered page can still have has_next_page true.
    */
-  export interface TweetSearchCoverageResponse
-    extends Omit<Shared.PaginatedTweets, 'has_next_page' | 'next_cursor'> {
+  export interface TweetSearchCoverageResponse extends Omit<
+    Shared.PaginatedTweets,
+    'has_next_page' | 'next_cursor'
+  > {
     /**
      * Coverage evidence across parallel search strategies.
      */
@@ -1276,13 +1280,7 @@ export namespace TweetSearchResponse {
         queryType: 'Latest' | 'Top';
 
         stopReason:
-          | 'cursor_failure'
-          | 'deadline'
-          | 'exhausted'
-          | 'failed'
-          | 'page_limit'
-          | 'result_limit'
-          | 'stalled';
+          'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
 
         strategy: number;
 
@@ -1574,7 +1572,7 @@ export interface TweetGetQuotesParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -1847,7 +1845,7 @@ export interface TweetGetRepliesParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -2081,17 +2079,178 @@ export interface TweetGetRetweetersParams {
 }
 
 export interface TweetGetThreadParams {
+  /**
+   * 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 thread tweets
    */
   cursor?: string;
 
+  /**
+   * Exact phrase to match.
+   */
+  exactPhrase?: string;
+
+  /**
+   * Words or quoted phrases to exclude. Separate with spaces, commas, or lines.
+   */
+  excludeWords?: string;
+
+  /**
+   * Filter by author username.
+   */
+  fromUser?: string;
+
+  /**
+   * Hashtags separated by spaces, commas, or lines.
+   */
+  hashtags?: string;
+
+  /**
+   * 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;
+
+  /**
+   * 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. minLikes is also accepted.
+   */
+  minFaves?: number;
+
+  /**
+   * Minimum quote count threshold.
+   */
+  minQuotes?: number;
+
+  /**
+   * Minimum replies threshold.
+   */
+  minReplies?: number;
+
+  /**
+   * Minimum retweets threshold.
+   */
+  minRetweets?: number;
+
+  /**
+   * Minimum view count threshold.
+   */
+  minViews?: 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.
    */
   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;
+
+  /**
+   * Start date in YYYY-MM-DD format.
+   */
+  sinceDate?: 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;
 }
 
 export interface TweetSearchParams {
@@ -2235,7 +2394,7 @@ export interface TweetSearchParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 

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

@@ -551,8 +551,7 @@ export interface UserRetrieveBatchResponse {
  * has_next_page is true.
  */
 export type UserRetrieveFollowersResponse =
-  | Shared.PaginatedUsers
-  | UserRetrieveFollowersResponse.UserListCoverageResponse;
+  Shared.PaginatedUsers | UserRetrieveFollowersResponse.UserListCoverageResponse;
 
 export namespace UserRetrieveFollowersResponse {
   /**
@@ -562,8 +561,10 @@ export namespace UserRetrieveFollowersResponse {
    * 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'> {
+  export interface UserListCoverageResponse extends Omit<
+    Shared.PaginatedUsers,
+    'has_next_page' | 'next_cursor'
+  > {
     /**
      * Coverage evidence across parallel relationship strategies.
      */
@@ -621,13 +622,7 @@ export namespace UserRetrieveFollowersResponse {
         pagesFetched: number;
 
         stopReason:
-          | 'cursor_failure'
-          | 'deadline'
-          | 'exhausted'
-          | 'failed'
-          | 'page_limit'
-          | 'result_limit'
-          | 'stalled';
+          'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
 
         strategy: number;
 
@@ -645,8 +640,7 @@ export namespace UserRetrieveFollowersResponse {
  * has_next_page is true.
  */
 export type UserRetrieveFollowingResponse =
-  | Shared.PaginatedUsers
-  | UserRetrieveFollowingResponse.UserListCoverageResponse;
+  Shared.PaginatedUsers | UserRetrieveFollowingResponse.UserListCoverageResponse;
 
 export namespace UserRetrieveFollowingResponse {
   /**
@@ -656,8 +650,10 @@ export namespace UserRetrieveFollowingResponse {
    * 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'> {
+  export interface UserListCoverageResponse extends Omit<
+    Shared.PaginatedUsers,
+    'has_next_page' | 'next_cursor'
+  > {
     /**
      * Coverage evidence across parallel relationship strategies.
      */
@@ -715,13 +711,7 @@ export namespace UserRetrieveFollowingResponse {
         pagesFetched: number;
 
         stopReason:
-          | 'cursor_failure'
-          | 'deadline'
-          | 'exhausted'
-          | 'failed'
-          | 'page_limit'
-          | 'result_limit'
-          | 'stalled';
+          'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
 
         strategy: number;
 
@@ -739,8 +729,7 @@ export namespace UserRetrieveFollowingResponse {
  * has_next_page is true.
  */
 export type UserRetrieveVerifiedFollowersResponse =
-  | Shared.PaginatedUsers
-  | UserRetrieveVerifiedFollowersResponse.UserListCoverageResponse;
+  Shared.PaginatedUsers | UserRetrieveVerifiedFollowersResponse.UserListCoverageResponse;
 
 export namespace UserRetrieveVerifiedFollowersResponse {
   /**
@@ -750,8 +739,10 @@ export namespace UserRetrieveVerifiedFollowersResponse {
    * 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'> {
+  export interface UserListCoverageResponse extends Omit<
+    Shared.PaginatedUsers,
+    'has_next_page' | 'next_cursor'
+  > {
     /**
      * Coverage evidence across parallel relationship strategies.
      */
@@ -809,13 +800,7 @@ export namespace UserRetrieveVerifiedFollowersResponse {
         pagesFetched: number;
 
         stopReason:
-          | 'cursor_failure'
-          | 'deadline'
-          | 'exhausted'
-          | 'failed'
-          | 'page_limit'
-          | 'result_limit'
-          | 'stalled';
+          'cursor_failure' | 'deadline' | 'exhausted' | 'failed' | 'page_limit' | 'result_limit' | 'stalled';
 
         strategy: number;
 
@@ -1247,7 +1232,7 @@ export interface UserRetrieveLikesParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -1482,7 +1467,7 @@ export interface UserRetrieveMediaParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -1717,7 +1702,7 @@ export interface UserRetrieveMentionsParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -1968,7 +1953,7 @@ export interface UserRetrieveRepliesParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 
@@ -2295,7 +2280,7 @@ export interface UserRetrieveTweetsParams {
   minBookmarks?: number;
 
   /**
-   * Minimum likes threshold.
+   * Minimum likes threshold. minLikes is also accepted.
    */
   minFaves?: number;
 

package/src/version.ts

@@ -2,4 +2,4 @@
 //
 // SPDX-License-Identifier: Apache-2.0
 
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.12.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.12.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.11.0";
+export declare const VERSION = "0.12.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -4,5 +4,5 @@
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.11.0'; // x-release-please-version
+exports.VERSION = '0.12.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,5 +1,5 @@
 // SPDX-FileCopyrightText: 2026 Xquik contributors
 //
 // SPDX-License-Identifier: Apache-2.0
-export const VERSION = '0.11.0'; // x-release-please-version
+export const VERSION = '0.12.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map