x-twitter-scraper 0.8.4 → 0.10.0

package/src/resources/guest-wallets.ts

@@ -15,11 +15,9 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class GuestWallets extends APIResource {
   /**
-   * Create a one-use Stripe-hosted checkout after the user explicitly confirms a
-   * $10-$250 USD amount. This request creates no charge by itself. The user opens
-   * checkout_url on Stripe. This endpoint returns the paid-read API key without
-   * requiring an Xquik account, email, dashboard, or Xquik web page. An idempotent
-   * replay returns the same key.
+   * Create a one-use hosted checkout after the user confirms $10-$250 USD. The
+   * request creates no charge. It returns a paid-read API key without an Xquik
+   * account. Replays return the same key.
    *
    * @example
    * ```ts
@@ -41,10 +39,9 @@ export class GuestWallets extends APIResource {
   }
 
   /**
-   * Poll after Stripe payment. Use usable to decide whether paid reads can run. An
-   * active wallet can remain usable while a top-up is pending. A new wallet becomes
-   * usable only after verified webhook fulfillment. Send the guest key as
-   * Authorization: Bearer.
+   * Poll after payment. Use usable to decide whether paid reads can run. An active
+   * wallet can remain usable while a top-up is pending. A new wallet becomes usable
+   * only after payment is verified. Send the guest key as Authorization: Bearer.
    *
    * @example
    * ```ts
@@ -59,10 +56,9 @@ export class GuestWallets extends APIResource {
   }
 
   /**
-   * Create a one-use Stripe-hosted checkout for an existing paid-read guest key
-   * after the user explicitly confirms a $10-$250 USD amount. The key remains the
-   * same. This request creates no charge by itself and never redirects through an
-   * Xquik web page.
+   * Create a one-use hosted checkout after the user confirms a $10-$250 USD amount
+   * for an existing paid-read guest key. The key remains the same. This request
+   * creates no charge and never redirects through Xquik.
    *
    * @example
    * ```ts
@@ -116,7 +112,7 @@ export interface GuestWalletCreateResponse {
   authorization: GuestWalletCreateResponse.Authorization;
 
   /**
-   * Raw Stripe-hosted checkout URL for user interaction.
+   * Hosted checkout URL for user interaction.
    */
   checkout_url: string;
 
@@ -132,7 +128,10 @@ export interface GuestWalletCreateResponse {
    */
   expires_at: string;
 
-  instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+  /**
+   * Hosted checkout and status polling instructions.
+   */
+  instructions: string;
 
   /**
    * Wait at least this long before polling status_url.
@@ -230,7 +229,7 @@ export namespace GuestWalletRetrieveStatusResponse {
 }
 
 /**
- * Pending Stripe checkout and guest wallet purchase details.
+ * Pending hosted checkout and guest wallet purchase details.
  */
 export interface GuestWalletTopupResponse {
   account_required: false;
@@ -241,7 +240,7 @@ export interface GuestWalletTopupResponse {
   amount: GuestWalletAmount;
 
   /**
-   * Raw Stripe-hosted checkout URL for user interaction.
+   * Hosted checkout URL for user interaction.
    */
   checkout_url: string;
 
@@ -255,7 +254,10 @@ export interface GuestWalletTopupResponse {
    */
   expires_at: string;
 
-  instructions: 'Give checkout_url to the user. They must complete payment on Stripe. Never submit payment for them. After payment, poll status_url every poll_after_seconds until latest_purchase.status is no longer pending.';
+  /**
+   * Hosted checkout and status polling instructions.
+   */
+  instructions: string;
 
   /**
    * Wait at least this long before polling status_url.

package/src/resources/monitors/monitors.ts

@@ -120,6 +120,16 @@ export interface Monitor {
   username: string;
 
   xUserId: string;
+
+  /**
+   * When Xquik automatically paused this monitor.
+   */
+  pausedAt?: string;
+
+  /**
+   * Why Xquik automatically paused this monitor.
+   */
+  pausedReason?: 'x_user_not_found';
 }
 
 export interface MonitorCreateResponse {

package/src/resources/shared.ts

@@ -307,6 +307,7 @@ export interface Error {
     | 'missing_params'
     | 'missing_query'
     | 'monitor_already_exists'
+    | 'monitor_profile_unavailable'
     | 'no_media'
     | 'no_credits'
     | 'no_subscription'
@@ -324,6 +325,8 @@ export interface Error {
     | 'checkout_unavailable'
     | 'connection_challenge_expired'
     | 'connection_challenge_inactive'
+    | 'coverage_cursor_gone'
+    | 'coverage_cursor_unavailable'
     | 'draft_not_found'
     | 'favoriters_unavailable'
     | 'forbidden'
@@ -333,6 +336,7 @@ export interface Error {
     | 'idempotency_conflict'
     | 'idempotency_key_conflict'
     | 'invalid_community_id'
+    | 'invalid_coverage_cursor'
     | 'invalid_idempotency_key'
     | 'invalid_list_id'
     | 'invalid_payment_amount'
@@ -432,6 +436,7 @@ export namespace Error {
       | 'missing_params'
       | 'missing_query'
       | 'monitor_already_exists'
+      | 'monitor_profile_unavailable'
       | 'no_media'
       | 'no_credits'
       | 'no_subscription'
@@ -449,6 +454,8 @@ export namespace Error {
       | 'checkout_unavailable'
       | 'connection_challenge_expired'
       | 'connection_challenge_inactive'
+      | 'coverage_cursor_gone'
+      | 'coverage_cursor_unavailable'
       | 'draft_not_found'
       | 'favoriters_unavailable'
       | 'forbidden'
@@ -458,6 +465,7 @@ export namespace Error {
       | 'idempotency_conflict'
       | 'idempotency_key_conflict'
       | 'invalid_community_id'
+      | 'invalid_coverage_cursor'
       | 'invalid_idempotency_key'
       | 'invalid_list_id'
       | 'invalid_payment_amount'
@@ -545,10 +553,10 @@ export type EventType =
   | 'profile.unavailable.changed';
 
 /**
- * Paginated tweets. Source visibility, filters, or remaining credits can reduce
- * results. An empty filtered page can still have has_next_page true. Follow
- * next_cursor while has_next_page is true. Zero affordable results returns 402
- * insufficient_credits.
+ * No-mode search, user Tweet, user reply, and direct reply reads use automatic
+ * coverage. Shape, filters, aliases, and billing stay compatible. Unprefixed
+ * 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 PaginatedTweets {
   has_next_page: boolean;
@@ -559,11 +567,11 @@ export interface PaginatedTweets {
 }
 
 /**
- * Paginated user profiles. The item count can be lower than pageSize when the
- * source returns fewer profiles or the available usage balance covers fewer results. Follow
- * next_cursor while has_next_page is true. A relationship can naturally contain
- * fewer profiles than requested. Zero affordable results returns 402
- * insufficient_credits.
+ * 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 PaginatedUsers {
   has_next_page: boolean;

package/src/resources/support/attachments.ts

@@ -0,0 +1,57 @@
+// SPDX-FileCopyrightText: 2026 Xquik contributors
+//
+// SPDX-License-Identifier: Apache-2.0
+
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Support ticket management
+ */
+export class Attachments extends APIResource {
+  /**
+   * Streams an authenticated user's support image or video. Video requests support
+   * one standard byte range for seeking and resumable playback.
+   *
+   * @example
+   * ```ts
+   * const response = await client.support.attachments.download(
+   *   'att_a1b2c3d4e5f6a1b2c3d4e5f6',
+   * );
+   *
+   * const content = await response.blob();
+   * console.log(content);
+   * ```
+   */
+  download(
+    id: string,
+    params: AttachmentDownloadParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<Response> {
+    const { Range } = params ?? {};
+    return this._client.get(path`/support/attachments/${id}`, {
+      ...options,
+      headers: buildHeaders([
+        { Accept: 'application/octet-stream', ...(Range != null ? { Range: Range } : undefined) },
+        options?.headers,
+      ]),
+      __binaryResponse: true,
+    });
+  }
+}
+
+export interface AttachmentDownloadParams {
+  /**
+   * Optional single byte range
+   */
+  Range?: string;
+}
+
+export declare namespace Attachments {
+  export { type AttachmentDownloadParams as AttachmentDownloadParams };
+}

package/src/resources/support/index.ts

@@ -4,6 +4,7 @@
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export { Attachments, type AttachmentDownloadParams } from './attachments';
 export { Support } from './support';
 export {
   Tickets,

package/src/resources/support/support.ts

@@ -5,6 +5,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as AttachmentsAPI from './attachments';
+import { AttachmentDownloadParams, Attachments } from './attachments';
 import * as TicketsAPI from './tickets';
 import {
   TicketCreateParams,
@@ -19,12 +21,16 @@ import {
 } from './tickets';
 
 export class Support extends APIResource {
+  attachments: AttachmentsAPI.Attachments = new AttachmentsAPI.Attachments(this._client);
   tickets: TicketsAPI.Tickets = new TicketsAPI.Tickets(this._client);
 }
 
+Support.Attachments = Attachments;
 Support.Tickets = Tickets;
 
 export declare namespace Support {
+  export { Attachments as Attachments, type AttachmentDownloadParams as AttachmentDownloadParams };
+
   export {
     Tickets as Tickets,
     type TicketCreateResponse as TicketCreateResponse,

package/src/resources/x/accounts.ts

@@ -107,11 +107,9 @@ export interface XAccount {
   createdAt: string;
 
   /**
-   * Derived connection health. `healthy` = ready to use. `needsReauth` = user must
-   * submit fresh credentials. `locked` = X locked the account; unlock on x.com
-   * first. `suspended` = X banned the account. `recovering` = cooldown ended; the
-   * account can reconnect on its next use. `temporaryIssue` = temporary connection
-   * problem; wait before the next use.
+   * Derived health. `healthy` is ready. `needsReauth` needs credentials. `locked`
+   * must be unlocked on X. `suspended` is banned. `recovering` can reconnect. Wait
+   * before using `temporaryIssue`.
    */
   health: 'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue';
 

package/src/resources/x/communities/communities.ts

@@ -777,24 +777,164 @@ export interface CommunityDeleteParams {
 }
 
 export interface CommunityRetrieveMembersParams {
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
   /**
    * Pagination cursor
    */
   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;
+
   /**
    * Items per page (20-200, default 20). This is an upper bound for paid
    * authenticated calls: available usage balance can reduce the returned page size, and
    * zero affordable results returns 402 insufficient_credits.
    */
   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 CommunityRetrieveModeratorsParams {
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
   /**
    * Pagination cursor for community moderators
    */
   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 CommunityRetrieveSearchParams {

package/src/resources/x/index.ts

@@ -75,6 +75,7 @@ export {
   type TweetRetrieveResponse,
   type TweetDeleteResponse,
   type TweetGetRepliesResponse,
+  type TweetSearchResponse,
   type TweetCreateParams,
   type TweetListParams,
   type TweetDeleteParams,
@@ -89,6 +90,9 @@ export {
   Users,
   type UserRemoveFollowerResponse,
   type UserRetrieveBatchResponse,
+  type UserRetrieveFollowersResponse,
+  type UserRetrieveFollowingResponse,
+  type UserRetrieveVerifiedFollowersResponse,
   type UserRemoveFollowerParams,
   type UserRetrieveBatchParams,
   type UserRetrieveFollowersParams,

package/src/resources/x/lists.ts

@@ -69,30 +69,169 @@ export class Lists extends APIResource {
 }
 
 export interface ListRetrieveFollowersParams {
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
   /**
    * Pagination cursor for list followers
    */
   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 ListRetrieveMembersParams {
+  /**
+   * Match any comma-separated or line-separated bio term, ignoring case.
+   */
+  bioContains?: string;
+
   /**
    * Pagination cursor for list members
    */
   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;
+
   /**
    * Members per page (20-200, default 20)
    */
   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 ListRetrieveTweetsParams {

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

@@ -26,6 +26,7 @@ export {
   type TweetRetrieveResponse,
   type TweetDeleteResponse,
   type TweetGetRepliesResponse,
+  type TweetSearchResponse,
   type TweetCreateParams,
   type TweetListParams,
   type TweetDeleteParams,