x-twitter-scraper 0.6.1 → 0.7.0

package/src/resources/radar.ts

@@ -37,12 +37,26 @@ export interface RadarItem {
 
   createdAt: string;
 
+  /**
+   * BCP-47 language code. und means the source did not identify a language.
+   */
   language: string;
 
   /**
    * Source-specific fields. Shape varies per source:
    *
-   * - reddit: { subreddit: string, author: string }
+   * - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+   *   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+   *   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+   *   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+   *   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+   *   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+   *   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+   *   public net score. Exact public upvote and downvote counts are not available.
+   *   Estimated counts derive from the public score and upvote ratio, which Reddit
+   *   may fuzz. Comment bodies are not included. Current items combine public
+   *   listing discovery with server-rendered post data and use `sourceFormat: html`;
+   *   `json` and `rss` remain for legacy rows.
    * - github: { starsToday: number }
    * - hacker_news: { points: number, numberComments: number }
    * - google_trends: { approxTraffic: number }
@@ -50,9 +64,14 @@ export interface RadarItem {
    * - wikipedia: { views: number }
    * - trustmrr: { mrr, growthPercent, last30Days, total, customers,
    *   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
-   *   growthMrrPercent?, multiple?, paymentProvider?, rank? }
+   *   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+   *   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+   *   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+   *   growth source, xHandle is the founder's X username without @. The rank field
+   *   is the source's revenue rank. Result order represents reported 30-day
+   *   revenue-growth rank.
    */
-  metadata: { [key: string]: unknown };
+  metadata: RadarItem.Metadata;
 
   publishedAt: string;
 
@@ -71,11 +90,72 @@ export interface RadarItem {
 
   description?: string;
 
+  /**
+   * Source image. Startup growth items return the logo here.
+   */
   imageUrl?: string;
 
   url?: string;
 }
 
+export namespace RadarItem {
+  /**
+   * Source-specific fields. Shape varies per source:
+   *
+   * - reddit: { author, authorId?, subreddit, subredditId?, subredditSubscribers?,
+   *   sourceFormat, score?, upvoteRatio?, estimatedUpvotes?, estimatedDownvotes?,
+   *   numberComments?, numberCrossposts?, selftext?, contentUrl?, domain?,
+   *   postHint?, linkFlairText?, distinguished?, totalAwardsReceived?, viewCount?,
+   *   editedAt?, galleryImageUrls?, redditVideo?, archived?, contestMode?,
+   *   isCrosspostable?, isMeta?, isNsfw?, isOriginalContent?, isRobotIndexable?,
+   *   isSelf?, isSpoiler?, isVideo?, locked?, stickied? }. `score` is Reddit's
+   *   public net score. Exact public upvote and downvote counts are not available.
+   *   Estimated counts derive from the public score and upvote ratio, which Reddit
+   *   may fuzz. Comment bodies are not included. Current items combine public
+   *   listing discovery with server-rendered post data and use `sourceFormat: html`;
+   *   `json` and `rss` remain for legacy rows.
+   * - github: { starsToday: number }
+   * - hacker_news: { points: number, numberComments: number }
+   * - google_trends: { approxTraffic: number }
+   * - polymarket: { volume24hr: number }
+   * - wikipedia: { views: number }
+   * - trustmrr: { mrr, growthPercent, last30Days, total, customers,
+   *   activeSubscriptions, onSale, xHandle?, category?, askingPrice?, country?,
+   *   foundedDate?, googleSearchImpressionsLast30Days?, growthMrrPercent?,
+   *   multiple?, paymentProvider?, profitMarginLast30Days?, rank?,
+   *   revenuePerVisitor?, targetAudience?, visitorsLast30Days? } For the startup
+   *   growth source, xHandle is the founder's X username without @. The rank field
+   *   is the source's revenue rank. Result order represents reported 30-day
+   *   revenue-growth rank.
+   */
+  export interface Metadata {
+    author?: string;
+
+    contentUrl?: string;
+
+    estimatedDownvotes?: number;
+
+    estimatedUpvotes?: number;
+
+    numberComments?: number;
+
+    score?: number;
+
+    selftext?: string;
+
+    /**
+     * Current items use html. json and rss are retained for legacy rows.
+     */
+    sourceFormat?: 'html' | 'json' | 'rss';
+
+    subreddit?: string;
+
+    upvoteRatio?: number;
+
+    [k: string]: unknown;
+  }
+}
+
 export interface RadarRetrieveTrendingTopicsResponse {
   hasMore: boolean;
 

package/src/resources/x/account-connection-attempts.ts

@@ -0,0 +1,100 @@
+// 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 { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Connected X account management
+ */
+export class AccountConnectionAttempts extends APIResource {
+  /**
+   * Get X account connection status
+   *
+   * @example
+   * ```ts
+   * const accountConnectionAttempt =
+   *   await client.x.accountConnectionAttempts.retrieve(
+   *     'xatt_0123456789abcdef0123456789abcdef',
+   *   );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<AccountConnectionAttemptRetrieveResponse> {
+    return this._client.get(path`/x/account-connection-attempts/${id}`, options);
+  }
+}
+
+/**
+ * The connection is still in progress.
+ */
+export type AccountConnectionAttemptRetrieveResponse =
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptPending
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptSuccess
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionAttemptFailed
+  | AccountConnectionAttemptRetrieveResponse.XAccountConnectionChallenge;
+
+export namespace AccountConnectionAttemptRetrieveResponse {
+  /**
+   * The connection is still in progress.
+   */
+  export interface XAccountConnectionAttemptPending {
+    id: string;
+
+    object: 'x_account_connection_attempt';
+
+    pollAfterMs: number;
+
+    status: 'pending';
+  }
+
+  /**
+   * The account connected successfully.
+   */
+  export interface XAccountConnectionAttemptSuccess {
+    id: string;
+
+    object: 'x_account_connection_attempt';
+
+    status: 'success';
+  }
+
+  /**
+   * The connection reached a final failure.
+   */
+  export interface XAccountConnectionAttemptFailed {
+    id: string;
+
+    error: string;
+
+    object: 'x_account_connection_attempt';
+
+    retryable: boolean;
+
+    status: 'failed';
+
+    reason?: string;
+  }
+
+  /**
+   * Resumable account connection challenge. Submit the email code to finish the same
+   * connection attempt.
+   */
+  export interface XAccountConnectionChallenge {
+    id: string;
+
+    expiresAt: string;
+
+    message: string;
+
+    object: 'x_account_connection_challenge';
+
+    status: 'requires_email_code';
+
+    username: string;
+  }
+}
+
+export declare namespace AccountConnectionAttempts {
+  export { type AccountConnectionAttemptRetrieveResponse as AccountConnectionAttemptRetrieveResponse };
+}

package/src/resources/x/accounts.ts

@@ -21,12 +21,12 @@ export class Accounts extends APIResource {
    * const account = await client.x.accounts.create({
    *   email: 'account@example.invalid',
    *   password: '<ACCOUNT_PASSWORD>',
-   *   username: 'your_x_username',
    *   totp_secret: '<TOTP_SECRET>',
+   *   username: 'your_x_username',
    * });
    * ```
    */
-  create(body: AccountCreateParams, options?: RequestOptions): APIPromise<AccountCreateResponse> {
+  create(body: AccountCreateParams, options?: RequestOptions): APIPromise<unknown> {
     return this._client.post('/x/accounts', { body, ...options });
   }
 
@@ -107,11 +107,11 @@ export interface XAccount {
   createdAt: string;
 
   /**
-   * Derived connection health. `healthy` = session active. `needsReauth` = user must
+   * 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` = past cooldown, will
-   * auto-retry on next use. `temporaryIssue` = temporary connection problem; retry
-   * shortly.
+   * 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.
    */
   health: 'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue';
 
@@ -147,22 +147,7 @@ export interface XAccountDetail {
   updatedAt?: string;
 }
 
-/**
- * Sanitized X account summary returned by connect and reauth.
- */
-export interface AccountCreateResponse {
-  id: string;
-
-  createdAt: string;
-
-  health: 'healthy' | 'locked' | 'needsReauth' | 'recovering' | 'suspended' | 'temporaryIssue';
-
-  status: string;
-
-  xUserId: string;
-
-  xUsername: string;
-}
+export type AccountCreateResponse = unknown;
 
 export interface AccountListResponse {
   accounts: Array<XAccount>;
@@ -208,14 +193,14 @@ export interface AccountCreateParams {
   password: string;
 
   /**
-   * X username
+   * Authenticator App TOTP secret required for durable login
    */
-  username: string;
+  totp_secret: string;
 
   /**
-   * TOTP secret for 2FA
+   * X username
    */
-  totp_secret?: string;
+  username: string;
 }
 
 export interface AccountReauthParams {
@@ -230,7 +215,7 @@ export interface AccountReauthParams {
   email?: string;
 
   /**
-   * TOTP secret for 2FA re-authentication
+   * Replacement Authenticator App TOTP secret. Omit it to reuse the saved secret.
    */
   totp_secret?: string;
 }

package/src/resources/x/index.ts

@@ -4,6 +4,10 @@
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  AccountConnectionAttempts,
+  type AccountConnectionAttemptRetrieveResponse,
+} from './account-connection-attempts';
 export {
   AccountConnectionChallenges,
   type AccountConnectionChallengeSubmitResponse,

package/src/resources/x/x.ts

@@ -6,6 +6,11 @@
 
 import { APIResource } from '../../core/resource';
 import * as Shared from '../shared';
+import * as AccountConnectionAttemptsAPI from './account-connection-attempts';
+import {
+  AccountConnectionAttemptRetrieveResponse,
+  AccountConnectionAttempts,
+} from './account-connection-attempts';
 import * as AccountConnectionChallengesAPI from './account-connection-challenges';
 import {
   AccountConnectionChallengeSubmitParams,
@@ -122,6 +127,8 @@ export class X extends APIResource {
   accounts: AccountsAPI.Accounts = new AccountsAPI.Accounts(this._client);
   accountConnectionChallenges: AccountConnectionChallengesAPI.AccountConnectionChallenges =
     new AccountConnectionChallengesAPI.AccountConnectionChallenges(this._client);
+  accountConnectionAttempts: AccountConnectionAttemptsAPI.AccountConnectionAttempts =
+    new AccountConnectionAttemptsAPI.AccountConnectionAttempts(this._client);
   bookmarks: BookmarksAPI.Bookmarks = new BookmarksAPI.Bookmarks(this._client);
   lists: ListsAPI.Lists = new ListsAPI.Lists(this._client);
 
@@ -391,6 +398,7 @@ X.Profile = Profile;
 X.Communities = Communities;
 X.Accounts = Accounts;
 X.AccountConnectionChallenges = AccountConnectionChallenges;
+X.AccountConnectionAttempts = AccountConnectionAttempts;
 X.Bookmarks = Bookmarks;
 X.Lists = Lists;
 
@@ -505,6 +513,11 @@ export declare namespace X {
     type AccountConnectionChallengeSubmitParams as AccountConnectionChallengeSubmitParams,
   };
 
+  export {
+    AccountConnectionAttempts as AccountConnectionAttempts,
+    type AccountConnectionAttemptRetrieveResponse as AccountConnectionAttemptRetrieveResponse,
+  };
+
   export {
     Bookmarks as Bookmarks,
     type BookmarkRetrieveFoldersResponse as BookmarkRetrieveFoldersResponse,

package/src/version.ts

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

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.6.1";
+export declare const VERSION = "0.7.0";
 //# 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.6.1'; // x-release-please-version
+exports.VERSION = '0.7.0'; // 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.6.1'; // x-release-please-version
+export const VERSION = '0.7.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map